Apple II hrtp://www.turbo-2. com/apple 

Apple II Monitors Peeled 



DISCLAIMER OF ALL WARRANTIES AND LIABILITY 



APPLE e5»tPUTEK INC. MAKES NO WARRANTIES, EITIIEK F.XI'lll'SS (HI ffll'l, IHW, 

HlTil RESPECT TO T}1IE flAIlUAL 08- WITK RfiSBECT T0 TOE WTWAW! llWl'ttlU HKli 

m THIS MANUAL, IIS QUALITY,. pgRMgfiAiicB , mscitayTABitiw, m vrwm 

FOR AMY PARTICULAU PURPOSE, ^hf. COMPUTER INC. S0f^WA8K IH WW' "K' 
LICENSED "AS IS". THE f!NTI"RE EIBK AS TO ITS QUALITY AHIl rnHFORHANCl*; IH 
WITH Tim BUYER, ^faiTLD' XHE ESOGRAIIS PROUE DEFECTIVE; FflM.OW I NC 'niHtH 

Purchase, THE itiHa f "aSU- Mw apple coj:puter inc.. its nTSTiiiiiwi'uit. mi 

ITS RETAILER) ASSUMES THE EHTIRE COST OF ALL NtXHSSAKV SEK V 1 1 : 1 rii : , 
repair, or CORRECTION AfJD ANY INCIDENTAL OR CONS[:f)[[|'.Ni I Ai. [)AMAM',:;. Ill 
NO EVENT WILL APPLE COMPUTER INC. RE LIARLi'; FOP IMKI'C'I'. INniHI'CT, 
INCIDENTAT., OR CONSF.QUENT I ftL DAMAGES RESULTING FIJOM ANY I iCKl'i "I' IN ■['111' 
SOFTWARE, EVEN IF APPLE COhTUTKR INC. MAS REHN AllVISlvU uK 'I'MI' 
POSSIBILITY OF SUCH DAMACES. SOME STATES DO NOT ALLOW Tfll': rXCI.IIMdN Oil 
LIMITATION OP IMPLIED WARRANTIES OR LIABILITY FOR L'!C NH'MTAI. OH 
CONSEQUENTIAL DAMAGES, SO THF, ABOVE LIMITATION OR EXCLUSION MAY NUT 
APPL-i TO^ YOU. 



This mamiiil is copyrighted and contains jiropr 1 et ry I ii I o rm/i 1 1 <iii ■ All 
rights are rescuvcJ . This document may aot , in wholt' or iiiirc, hp 
eoplcd, photocopied, reproduced, translated or reduced to any 
el fecit e^nte wdtiim 'O?- Bta:<ail^^ j^^ble form wlthiXit urltiV cronncoi . In 
wrttliig, (toIh Apple Conrpiiter Inc. 



©1981 by APPLE fSSff^TER IMC. 
10260 Bandley DclYfc 
(Uipertino , California 95(JU 



The word APPLK and the Apple logo a;:e regist^ered tradc-marftH dI 
APPLF. COMPUTl'R INC. 

APPLE Product (?D2LO013 



Printed in USA 



* ^ Apple II 

■- ^Applel Monitors Peeled 



ft! r9 

I- ^ 



IE 



to 9 



TABLE OF CONTENTS 




PREFACE 


vil 


INTRODUCTION 


vll 


OVERVIEW 


vlll 


CHAPTER 1 




MEMORY ALLOCATION 


1 



1 Honitor Usage Menory tlap 

2 RAH Heraocy Allocation Ijy AddreSa" 

3 Page Zero 

3 Page Zero Fields 

1 3 Pages One throL.igh Thr(?(? 
13 Page One (50100 - 01FF) 
13 Pgge Two C$0200 - 02FF) 
13 pg^: 1Ehce-#" - 03PF) 

15 SArajeK IfeEKSiB^ ■MS-tess T«t»le 

16. P^MptvfetS'I Eototi'QtlST m¥k A#^as 



ii MONITORS PEELED 



CHAPTERS 

INPUT AND OUTPUT 



17 



17 Keyboard Input Division of Labor 

IJi Table of Routines 

21 Calls to Keyboard Input Routines 

21 Sable- <jE Keyboard Input Calls 

34. ^jBTlS itoutine Replacement 

f5, KBybp^fd Tn.put Monitor Eoucine 

2fi Address Table 1 r- aialactftt Inptit 

a? Address Table 2 - Iilne Tjipuc 

28 Overview - Tent flutput to the Screen 

25 Output within the Scroll Windovj 

il Page Zero Fields 

"^'1 Scroll Window OviCput Ravitines 
.S( Tfon Fomat Control by Routine 

i') Srrocu Forciat Control by Poke/Score 

36 Scroll Window Data Hanfpulatlons 

36 Address Tabls 

38 'Cursor Position Control 

39 Address Table 

'i I Centura] Text to the Screen 

/( 1 Address Table 

A 3 Control Char;ieLcrs 

i3 thitput witbouL the Scroll Window 

45 Address Table 

Af> Applesoft Sample Program 

47 -S«*e^R'da¥^ l>lgjJl-i^ Areas 

47 G&^y '■WtMapy, t© Secondary 

48 Set' «^:Ii,H fie^p. Secondary Bi^plSy 

48 Address Tabfe. 

49 Direct Control AddfeHs^s- 

■5^ Integer BASIC Sample Program 

50 Applesoft Sample Progran 



WBt£ OF CONTENTS HI 



CHAPTER 3 

INTERRUPT PROCESSING 



53 Interrupt Processing. 

5i FF.RRT InterF«]«: 3!*t|«ort 

55 IRQ/BRK Inter^p,t KanB^ij:^ 

55 RESET interriiji-t - 'KM nwiita-t- 

55 Address '[ijli'tfe 

56 RESET Interi^pt - Autostart Monitor 
5? Inlttalize System Configuration 
5i3 Cold/Warra Detetaniaation 

5^ Power-On Inltialfzitlon 
5S System HesCart 

58 RESET Vector Modification by User 

59 Address Table 

61 IRQ/BRK Interrupts 

&1 IRQ/BRK "Interrupt KecosnlClon 

61 IRQ Interrupt [landling 
6,1 Bl!K Instruction Interrupt 

62 BRK Instruction - Saving of Status 
62 BRK Iiistructlon - Old rionlLor 

62 BRK Instruction - Autostart Monitor 

63 Address Table 



iv MOiyirO^: PEELED 



CHAPTER 4 

MISCELLANY 6^ 



65 Machine Language Deyelopment Aids 
65 Address Table 
67 LORES Floctiag 



68 AddTi^ 

69 Data MftlptllatlW FrnttiajiiS 
M. SoutJnes 

69 Memory to Memory Move 

-^T^ M 70 Jump to Address with Registers Loaded 

70 Increment Address Fields 
70 Save 65(^2 Registers 
70 Restore 6502 Registers 

70 Multiply Two Byte Fields 

71 Multiply Routine 

T2 Divide Four Jiyte Dividend by Two Byte Olyisc)* 

^ 73 Establish j RESET Vector 

^ ~3B 73 Convert flex Characters to Value foC Use 

73 Disassemble an Instruction 

7A Address Table 

75 Applesoft Sample Data ftin ipul at Ion Program 

76 Monitor Command Processor 

76 Entering the Monitor Command Processor 

77 Call.lng tte Monitor Commnd PrpfiesBor 
■?7 AdtJreSE Tafele 



8g "Spe^tetr Tiee tfiToagh -the, f^OilieOK 

81 ^feissette Tape Input and Gftifcput 

mire 

S2 REAB 

Sit Cassette Input /Out put Internal Routines- 

83 HEADR 

83 ED2BIT 

83 RDBIT 

83 RDBYTE 

_ 84 l^rnBIT 

g| M WRBYTE 

84 Paddles, Buttons anrf Annunciator I/O 

85 Came I/O Hardware Address Table 

85 WAIT Routine 

86 WAIT Routine Delay Times 

86 Use of Control-Y with Parameters 

87 Paddle luterf ere^ce - Sm^ple Program 

88 Registers for Msfe Hbnl'sst Calls 
8^ DeclaBi3 X% Hs* SoWj^f^ile.n 

8S, Ap.p3esciP"t Slajflsi^ ^i'ft^aat. 
Step and Trace PecilH.airl ci:eg 



TA8LE OF CONTENTS v 




vi MONITORS PEELED 




PREFil^OE 



Tlio Apple II Reference Manual contaltis s ^^fKtiplet-e' a»semM^ llstltjg- of 
the Monitor program In the Apple II. Tllia '^^g iX MfiliotS E.^Gj^^'ii 
Mamffll (this hook) contains (descriptions d£ Clie -varl-oua rfotitijies. ±n 

the Monitor address cables arranged 1^ feo^c Eii&fceHi. Oi to -fthe 

Hpqiience of location t-lthin tlie machine. Ttie material you find here 

bds been chosen and organized Co allow proRranmers of thp Apple II to 
Tiinkc convenient use of routines in the Monitot" from their proj^rams . 

N.'iny of Che CALl.able points In the flonitiir fall under raore than one 
Topic* The layovLt of this book ?s intemded Co iidnl mise Che 
iicccHsIty of page flipping and cross referencing, so those points 
wlilch seem to ho appropriately desc.ribeid utideC noxa than one topic 
will he found In each applicable table. 

riiis Hociiment covers the Apple II Monitor (both the Old Monitor and 
1 III' Autostart Monitor versions), ROM address range gF800-$FFFF. llils 
publication does not cover BASIC, APPLESOFT, DOS, HIRES, SWEErl6, or 
Floating Point Arithmetic utility routines. 

INTRODUCTION 



There ace twa KmiifeQJr ^KDM'S; d'ssrlla^l^ isji'^ ^itl'e K. Tlie two, 
HunlCoTs are fdenclea.! for most funetlona- ^ey ^ffe.r only in certain 
features. This hook describes both Monitors^ iifeh.- tndl^-ationB provided, 
whenever the Infonsatlon applies Co only one 'oi the tFO- 

Some thousands of Apple 11 computers have been shipped with the 
earlier version of the Monitor. In this book, chat wll be referred 
(11 ns the Old Monitor. In 1979, a new version of the Apple II Monitor 
w.i.'i developed. This Monitor contains new features to facilitate Bya.teni 
:itarC-U|"i and prap,r;im editinj^, at the expense of removlnp, the 
iiisCnicLion trace and single step facillries an.i sixteen bit multlply- 
rMvU-le routine of the lid Monitor. This new Monitor is called the 
AuCosttirt Monitor in this book. The Autostart Monitor is available 
from Apple Computer Inc. and frori many computer dealers under the 
nttrae AuCotftact RIIM, Apple- Part So. A2M0027, 

It easy to determine which Monitor is in a machine. If the machine 
comes up with the APPLE II legend at the top of the screen when the 
power Is turtlg'4 On, the niTchine contains the Autostart MonltO-P- T£ the 
machine cornea up with the Ifanlcor proinpt (*) then it contains the Old 
Honltilr. 

A TJfSgraiti cart ■'dgfeRj-Eag »ii»^t»^' eBb' Hsiiito-r is -the Sid or the 

AutoetarC ROM. The. Vfe,e' at ^AS^" 't^.i'iSS: or -128,1) contains iti the 
Autostart and S^l in tfte Sitf tfentCw. 
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OVERVIEW 



CHAPTER 1 

MONITOR USAGE t'lEMORY MAP 

Use of raenocy by the Monitor and by the Apple II tor nuu-lilno 
control aai. display to Che screen. 

PAGE ZERO 

Description in detail of all memory locations in page ?tri> uHcd 
by the Monitor, indicating legal range of values and all routlnan 
which use the location. 

PAGES ONE TriRO'UGH THRRF, 

General descriptions of pages one and two and spectElc 
description of fields In page three. 

PAGES FOUR THROUOt SEVKS AND ELEVEN 

Desc rlp-t-tM ttf- ftow ^ext 1» maintained, in "screen refresh raemory" 

af^ss fo'r text and" low I?e«o~luet^ 0bleE;5 ^ftjihlaca. 

PKRtPHF.RAL CONTROLLER WORK AREAS 

A chart showing the scratchpad .Teas available in RAM memory for 
use by peripheral controller programs. 

CHAPTER 2 

KEYBOARD INPUT DIVISION OF lAI'.OH 

Descriptions of the lower level routines used hy the Monitor to 
read data from the keybpard, including subroutines SoT cursoF 
moveiiicnt without reading characters. 

USER CALLS TO KEYBOARD INPUT ROUTINES 

Specifications for user calling of the routines at all levels for 
Input of characters from the keyboard and for user program 
simula-trlng '(>?epla(!ii>s} '-t^e 'k^i^vwcA as the inpiat device. 

Ebe. ■keyboard via tbe roatines desc-rf'bed in the -previous seatian. 
Table 2 c<irtt'alna addresses for Hne Input It'am Elje keyboard. 

OVHRVTKW - TECT OirCPUT TO THE SCREEN 

Because there are so many ways to write text to the screen, this 
section contains an overview of the following psges on screen output 

TEXT OUTPUT WTTMTN TIIE SCROLL WINDOW 

Detailed description of the normal method of printing data to the 
screen, as used by PRINT of BASIC, Including page zero reference 
table for Scroll Window services. 



SCREES' FOEMAT CONTROL BY ROUTINE 

Table of addresses of rontlnes In the Monitor which control the 
fftCmat of the Scroll Window and the format of data dlBplay. 

'SCREEN FORMAT CONTROL BY POKE/STORK 

Description of methods of controlling the screen display format 
without Galling routines In the Monitor. 

SCROLL UTNUniJ DATA MMTBULATIONS 

Table of routines lAvich affect the data displayed In the Scroll 
Window, such as clearing part: of it or scrolling it. 

CURSOR PnSTTION CONTROL 

Description of facilities for moving the cursor relative to 
current tiosltion or to an absolute location. 

GENERAL TEJCC ^ 

^,s*'-a)*IS-^ie§ ^la C^-J se'SoI^,. and, |*jliirl-n& mm ttiings %r a aaH 
to a Steni'tor jootim f^i'iOs loatita -tl<e A-reg and calls .eou*' ItBclf.. 

TJ^XT OJJtPUT WITHOUT THE SCROLL WINDOW 

Ways and means of handling the screen as a formatted display 
device, with or without part of Che screen being defined as a 
Scroll Window. 

SECONDARY DISPLAY AREAS 

Dlfferesnt methods of getting data into the secondary text display 
area. 

CHAPTER 3 

OVERVIEW OF INTERRUPT PROCESSING 

General and specific a.ef,lnl.Cion of interrupts and Interrupt 
proe-essin^. with v^^sr0. Cf ESitSpT*-B*s In" 8ene;KSl apA the Apple II 
In partioul^r-r./ 

■%3et%H,ti» feS imilifeB RESET iriterruEt irft^ aaaress table 

RESET INTERRUPT - ,;gliTpSTART MOlUS^. 

Description handling a J^&T ixk&tr»pt witb aMi?ees< tatle 
allowing user call tt) subsets. Description of Soft Entry Vector 
setup and use. 

liiQ/HkK IHTKRRUPT HANDLING 

Desctlpt ions of i.iandling these types interniptS" by hath 
Monitors, with Address Tables-. 
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CHAPTER 4 



MACHINE LAHGUAGK DEVF.l.nPMENT AIDS 

Address ta"ble for routines In tlie Mpnitftr ahlch can be calj.oij Cd 
■[WfSiVlde debugging Information elth^ kry aovta^ «be fnfimifltlan m 
aoifie otfaer place In mepory or prlotlng luf amratlcn throuRh ClOUT. 

•LORIS- PLOTTING 

Descriptions; <if tfte rontlnea in. She' Rimftiir whteh wpport this 
fimctlon, 'Vlth a table of ;addr«sseS for directly calllna tTietn- 

DATA MANIPULATTOH FUKCTIONS 

Description of the routines in the Monllor which move datn I roin 
one place to another, or change the format, or Operate an one 
Item with regard to another. 

MONITOR CO>ff[AND PROCF.SSOR 

How to call the Monitor Comnand Processor, to have it ci^eriiti' 
Monitor commands and return to caller or stay In Monitor mode. 

SPEAKER (BELL) USE TOROdGH TilE MONITOR 

No music here. This is a deecxSt 1 1*5^ ^ 0®e Cfi^ affeaker Ns 

a sl^nalinj; device in the aame' manner aa the error alarm xir RRRRT 
fe-^ alarm. 

CASStEES iFAPK ^UPJJI MJB.> 

iJgaii-rt'pEl**! d^l tfee, leucines involved with reading or wri-llng 
&i- ia^; ^th -os'^ feall tefornatlon specified for the high ieve] 
routines. Includea liEt of -calling programs for each point. 

PADIiLES, BUTTOnS, AND ANNUMCIATOR I/O 

Description of paddle reading for the machine lanRuage programmer 
and addresses to use for all these devices. 

WAIT ROUTINE 

This routine will take, control of the machine for n lenf.th of 

time depending upon the Input A-ref; value. Table and formula ape 

provided for use wliere interval between events Is critical. 

USE OF COKTROL-Y WITH PARAMETERS 

Sample machine language, program for rapl4 reading' of the 
paddles. 

REGISTERS FOR BASIC MONITOR CALLS 

The Monitor GO tomtnand routine makes It possible to call from 
BASIC most Monitor routines which receive Input In registers. 

DECIiUt TO HEX GONVEREIOS 

A sattii*l'H (ftiigieam t"hsft shpwg how to convert f "4«caiaal to 
hexadecimal . 

STEP mU TRAiW. PECULIARITIES 

Biff.etetietes Ijetween operation of this, TOftB&inie; sdtli aafl .wi'frliouE 
Single Step in. the Old Monitor. 
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CHAPTER 1 

MEMORY ALLOCATION 

MONITOR USAGE MEMORY MAP 

Memory Is divided into 25(i hyt e sections, generally referred Lo as 
"I'aj^es". As with nhitst countable Ic^ms in c.ompucers , menory pages are 

iiumherod fron i;ero. Page ^ero is vary special in that [he full 

■■iddrt-fq.i of a byte in pa^e iiito i.iay be expressed In a ainfile byte, 
n.iny h'ji^'J processor ins true 1 iiins are only two bytes in lon^th betfausa 
the operand Is in page zero. Thus, Monitor usage of page zero 
ce:ceives heavy treatment In the following section. 

I'.if^c one (address range $0 l(j0-3Hlf H') is also special in the Applp II. 
I'his entire 256 byte area Is called the "stack". The stack is a 
Cfcmpoi-ary garage/' #r«S 't^t #2^6 ^ji^J^l -ia^tlWSfe'i^Rlf km -^Wt'd^' in 
the 'ftS02. fhe co.nteBt? -pt the.' ii*-,x^-a^'er ctr ^r,^stes tmc^, -fe jiushea 
-OAte EM 4t"a^., ■.^feM im'me, ifcte Wa&^!i\a of .ttie'' ftr*t'fe;a=tefl' regiHter" 
are ieto^ed in the Stai;& E^e iec.-atl-on currently specified by the 
S-re^ifelet"; then thfe' S-fS'gt'^tet- is decremented. Data nay be pulled or 
popped from the stack, which ine.ins that the ,S-reglster Is 
Incremented, and then the byte pointed at by the S-register is picked 
up into the appropriate register. A JSR instruction causes the 
current contents of the Program Counter to be pushed onto the stack 
bcToEo the .lump. An RTS instrnetioti pulls two bytes from the staclt 
into th<' Program Coiinter. 

[lie Monitor contains instructions which use the stack. However, the 
n.-iiiltor docs not initialize the stack pointer register to a preset 
v:!liri> or load the S-reg at any time. 

I'.il'.o two (addrosB rnnse S020O-502F(- ) is defined in the Apple II as the 
kfybn.ird input area. The rlonicor routines which support reading of 
tlic keyboard store the information Into page two for use by the 
^ -^^P calling prograio after the next carriage return 16 .detected. 

_ I'.ij'.c three Is address range Host of this area is unused 

.-^l l>V I'c Monitor. Quite often the first 206 or so bytes are used for" 

iii.u'liiue language programs called by APPLESOFT or BASIC progi^jpS. The 
fc-^B Monitor iMes only the last 16 bytes, as .described ta the Pa^e Ishiiee-. 

— AridposS' tA'iilS: (Note, lioweiver. that BC^ mM the, ■SktO-fe -Che 

^ Wnn.i£o'r''s ift-J 

Pofies four through seven comprise the primary text oir color graphics 
b ^1 display area. Pages eight thru eleven comprise the gecondary text or 

color graphics display area when that feature of the Apple II is 
_ used. However, page eight is generally the first page of the user 

■irci . In thf ,iddr£?ss table , pages four thru seven and eiy.ht through: 

eli>vL-Ti iire described together when specifying memory address per 
^g,. ■'^^Il screen line. 



MEMORY AaOCATION 1 



fiiM address 30800 to the end of iiieiiiory In the machine Is the user 
area for programs and data. However, if High Resolution Graphics 1 
In use, then memory area from $2000 through g3FFP is the primary 
display area for that function and $4000 through 55FFF may be used 
the secondary disRlay area for that fulfction. 



RAM MEMORY ALLOCATION BY ADDRESS 



WW 



(Page zero 



0100 
01FF 



1 



0ft 



oard lop^t 



0300 
03CF 
03D0 
03EF 
03F0 



lAvailable, 

I 

|T)OS 

IVectors 
I 



0^100 [Primary Text 
07FF land LORES Area 



0800 
0BFF 



2FFF 
3FFF 
AW 

5rFr 



lUser Program 
I and Data spacti 
I to RAM size. 

IROM APPLESOFT 
I USER, PROGRAM 
I 

I BASIC DATA 



Secondary Text 
and LORES 



Primary HIRES 



Secondary HIRES 



RAM APPLESOFT 
COMPILER/ 
INTERPRETER 



RAM AFELE^^FT 



3FFF 
7FFF 

BFFK -end U8K machine 



—end 1 mach i ne 
I 

-end 32K machine 
I 
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PAGE ZERO 



The Monitor makes use of the pa^e zero locations from 32 ($20) through 
73 (549} for general functions and norraal operations. Locations 74-77 
(SZiA-4d) are not touched by the Monitor. Locations 78-79 ($4E~4F) are 
modified as described below to provide a randon minber starting point 
for an application progran. 

In addition, the Old Monitor uses locations R0-R5 (550-55) for the 16 
hit Multiply and Divide routines (which are available for problem 
program use but are not used by any other part of the Monitor). These 
locations are not used, by the Autostart Monitor. 



The Autostart Monitor uses locations and 1 during .s; 
Initialization. This initialization is described in the sectlo-ii on 
"RKSET Interrupt - Autostart Itonitor" aad below in describing tJW USte 
of locations and 1. 



PAGE ZERO FIELDS 



t m 
H Jl 



Pec itex 



01 s^l 



Monitor 



LOC0 
LOCI 



■12 



320 



WMDLFT 



■Jl $21 HHDWDTH 



These locations are used by the Autostart itonitor 
during the automatic Disk Bootstrap function which 
takes place when the computer is powered up. (Islng 
these locations for Indirect addressing, the slot 
addresses are checlced - from slot 7 down thru 
slot 1 - to determine presence of a disk controller. 
If one is found, a Jump Indirect via S00-01 i'8 
executed to Initiate the bootstrap opej-ation. 

Left column of the Scroll Window: 
Range is to 39 (S27). 

This field is used only in VTABZ which sets BASl,,^ 
to the memory locatlofi^ ■C*>r"ce3p,ondlng ta CV ^nd 
WNDLFT. The contents, when changed hy- os'eF 
program, become effective or jai,e" '^:e^t' -SidrifJl 
Sjjera-Cl on , cleap to eitd ef p^e c^etatloii, or 
cacriasie )r«ti«» tiutpia:- fSl eoHEalAs 'cursor 
horizorLtal poait'lon reiative to (WMSLFT). 

After changing the contents of WNDLFT, either CALL 
VTAB or print a carriage return to the screen to 
Eiake it tsfke effect. 

Width of the Scroll Window: 
Range is 1 to 40-[WNI)LFT) . 

When a character is written through COUT to the 
screen it is placed at (BASL),CCn), after which CH 
is incremented. Then (Ctl) is compared with 
(WMDWDTH) to determine whether the cursor has 
exceeded the Clgh-t margin of thfe Sctioll Window. 
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Dec Kex lfeT5j~ES* 



D&scrlptlun 



34 322 WHDTOP Top line of the. Scroll Hindowt 

Ranse is 3 to 22 (SI6) for full text screen. 
Range iB tO 22 and $15) for mixed graphics 

and text. 

Valid values for VTAR in Basics are-. 21, ?2, 23. 
This field is used dnririK a scroll o|ieratior to 
indicate the line on which the operation shouM 
start:. It is also the line on which the cursor la 
pl^fced on rcinpletion of a HOME operation (.clear 
the window, place cursor at top lefc). 



35 S23 wndbt;i 



Nonvinallv, bottom lirie of Scroll Window: 
Range la Xmt^QWI^l torU 4:S'J85- 

WNDBTH contains- tlie mjntber of tW jirat line WIjkw 
the Scvol'l Wmtfcw. floiit.ent,?' of WD&OT Sre fcssceit 
OB eutjiat ot s carsi^ie, x&tura. l^^^ or line 
■JWit (-^nm. tt. Wat4 ■P^MT■ to^ f'-rsS: Of Page and. 



36 $24 'Gir ]>isplacement from MDl.FT where next chatarter to 

the screen will he placed: Range is to 
(WWIITH) - I. After the screen output routine 
RTOADV places a character into tl-ip screen areii as 
part of normal character output, CH is then 
1 ncrr^no nted and conpared to l/NttJDTH . If CH is not 
IpKf; than fiNDWIiTlr, a C:arriage return will he 
s iniul atfd . 

Note that CH 1 g used for echoing keyboard input to 
the screen by the. Hoiil tor RETLN etc. r.oiitines. 

3-7 S25 CV Vertical screen iiositlOTi (litie htirttier) far newt 

Character to b# wrllteo m the screen: Iknge Is 
to 23 (317). 'tti'k ^o'ite'* fB- r^lativsi'W' the 

top of the- Sfi.-re^,^ aac tit- tPP a# the ^«roll 
Wl'niiow. "It MJf 'S^k If^ii^ tfe' ^"^^{.-r^ line 



sailing WAS. Actual storage of a character into- 
the .Sareen area tnelUdes use of BARL,H for line 
miraliej', not (jV. The calls above to VTAB or TABV 

sfS t<J so.t BASLjO from CV (and IWhL.FT> for 
Immediate futwre reference. 

If CV is at or below WmRITT it will renain on Che 
current screen line as carriage returns go by 
vihile the contents of tiie Rcrolt Ul nd OW wi 1 1 be 
scrolled for each. 
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Itt'O Hex Moniror 

Addr Addr Label Description 



18 52fi GBASL ^r^&i^^. s^4*sBs UtUn the scre-en atea ef the left 
39 S27 GBAEIl etl^ WMt t^e ^Slred line for LORES plot, -nils 
-flSsltt Is- set -by the tiBASCALC routine to the memory 
location appropriate for the line number specified 
In the A-reg. See !-!ASK at $2E. 

^4 40- Mgl. This two tyte field is the memory address for the 

$29 BAStt left end character position of the current toxc line 
line, wlthlQ Che Scroll Window. The contents are a ' 
tncctibn of CV and WNDLFT. 

This field Is set b> Che RASCALC routine to point 
CO the memory address Zar the lefc end of Che 
screen line specified in the A-reg. This call to 
BASCALC is usually accomplished by the VTAB 
routine, wiiich then adds (HNDLFT) to BASL.H to 
point to the left end of the line vrfthin the 
Scroll Window. 

This two byte fi&H tiseS' AS- a -work area <Kdy 
during a scroll ^¥i^-£ien,. It Is the dS'Sfi tit^lon 
lipe poipW* «a«d -as -m^h iine is moved Co the 
position '.i^wve &]ftet\t^: 

'<'< $2C 112 Right end horizontal line being dravw hy 

the flli^g -routiftfef Range is to .39 ($27). 

fhls Htfe- is aet by Che calling program before 
HIlHl is called. 

" LElNSi Low byte of two byte pointer (LflNEH, WINKf-l) used 
by disassembler as index co rmemonics table. 

" RTNL Save area used by the Instruction Trace rouCine 

of Che aid l-tonltor. 

Boctom poinC of a verCical line being drawn by 
VLINE routine: Range is to 39 (S27) for nd^ed 

screen, « to 47 (S2F) for full screen graphiC,Si- 
This bytf. misc be set before VLI,NF (;a4 1^<J. " Mats 
that this byco is used when Che Clear ScTKen 
(CLRSCR) rouCine uses VLIHE to clear the iM^teen. 

raiNEM Used with UlNEM as table itKiex foC mertonic table 
by tlie msassemhJer. 

liTHH osed with SML.^:^ a s^ve area % the' Instr-uction 
Trace routine of t-he Old Honltoc. 



!a $2,\ 15AS2L 
4 3 S2B BAS2H 
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Dec Hex Monitor 
Addr Addr Label 



Description 



46 S2E MASK 



FOEtlAT 



CHKSUM 



i7 S2F LASTIN 



LE^IGTH 



SIGH 



With thiB label, this location Is viHP.d as a S0F 
or $F0 by PLOT depending on whet.lier the point is 
on the high side or the low side of the two 
horizontal plot lines represented by the GBASL,Il 
pointer. Each location of the form (GBASL),Y 
contains two points on the screen, one above the 
other. MASK is used to set Che appropriate qhg 
while leaving the .other unchanged. 

"OsiRS tills l^bel, eIi©' DIsasBeOfbl-^jr mm this byte 
as tettpprary Bforti&fe far the ct^da ^tt% Siidicacee 
the format of the Instruction tot- dlBplaji 
purposes. 

This byte Is used during cassette tape reail to 
continually accunulato the cheokiiiim wtilr.h will 
be compared to that generated di.irinf; the ^Jr i te 
operation which crcEited the record. This byte is 
initialized to zero at the heginning of a tape 
read. As each byte is stored into mcnory It is 
Exclusively ORed against CITKSirM. .^fter the last 
byte has been stored, one more byte is read from 

Che tape and conpared to GIIKSUM. If equal, a good 
read nay be assumed. As this result is not finally 
stored back, into CIIKSUM, chat field cannot be used 
by the calling program to determine success or 
failure of the read. A method for this 
determination will be found In the section 
"Cassette Tape Input and Output". 

With this label, the RDBIT routjTie usea this byte 
as a: work area Co ^eterEane "vSiWUfeir iAid' Sehae of 
Input from the casaette tape Input Tegister baa 
c banged, 

th^'. ItHjgfh" e$ -'the -tecti^jcsiog,, Mz-m: mtpu'r .t^. ihe- 
tflaassenililecl inetruct'ion, 'f'CkHJ' uses this value- to 
compute new values for PCL,H, which are returned 
to caller In the A and Y reg for user storage to 
PCL,H. Instruction trace in the Old Monitor also 
uses this field to indicate the number of bytes Co 
move to the Inatruetloti trace executiiW work area 
<XQT). 

After a call to lll'LCM or DIVl'H (signed lf> bit 
multiply or divide in the Old Monitor), the S^l 
hit of this byte is set if the always-positive 
result is tB be cofiiplefflented by the caHi-ng 
program. 



Description 



This, byCe contains the ^^Od© ^Bt 'fcjie- cqliit 
points to be placed on the aci*«l' ia- gX^Jlfes' 
mode. The SKTCOL routine Is" ^ Wlie 

In the low prder four bits M the ft^regk- thi^ 
value th&n plaeeli fe ^g-'b', the' an<S lix^ 

nibbles of COLOR. COLOR is tVw' ^til .in 

setting the value of the ^ijce "lit, s©*een ..Ste^ 
t.Q. -aw)RJpl-lB'h, settles a particular point to the 
"B-electe^- color. 

Colo* can be set directly by stuffing the value 
multiplied by $11 in color. For example, 
color - orange (9); From assembly - LDA 1199, 
STA color. Prom BASIC - POKE 48, 9*17. 

This byte is used by the Monitor command 
processing routines to control parsing and to 
control operations when a blank is encountered 
after the hex digits. For example, a hex address 
followed by a colon causes .■;etc;ng of MODE so thaC 
during further processing of the input line each 
blank encountered signifies end of a hex vall^ ^%o" 
be placed in memory. During parsing, the contents 
of MODE indicate where the hex values should be 
stored for use when the command itself Is 
encountered. MODE is set to approiir'iate values by 
plus, minus, colon, and period. 

This byte Is a mask used by COOTl ta- «aws-e 
characters written to the screen area td riiSplSy 
wbite on black (INVFLG-SFF) or black on rfiite 
(lHVFLG=.S3r) or blinking (INVFLG=S7F) . This field 
is set to SFF when a RESET occurs by the routine 
at &BTHOto*V The routine called SKTINV can be 
eallefl Ca Set reverse video. The ItonlEor does aot 
set blinking. 

This byte contains the prompt character which Is 
written to the screen by the Monitor GFTLN routine 
In preparation for reading a line of characters 
froci itie keyboard. When the RF.SET key is pressed, 
the (lid Monitor quickly enters the liOlI routine, at 
which point the PROMPT field is set to SAA, "*", 
The Autostart Monitor also sets the "*" prompt 
character at the MOH routine, but this is not 
necessarily a part of processing the RESET 
Interrupt. 
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Bee Hex Monitor 

&Mr Addr Label Description 



52 534 YSA7 This- byt.e Is a save area used by the ffonitor 

Coniinand Processor. The ¥-reg is used by the 
Command Processor in indexing through the Input 
line. When a command has been decoded, the Y-reg Is 
saved at YSAV before" going to the selected service 
routine. On retiirn to the Command Processor, the 
Y-reg Is reloaded from here before transfer of 
control to NXTITM to continue scanning the input 
lljie. 

53 535 YSAVl Tbla byce la a SaVe ifrS^. ^.t iStfi' I^e-eg across a 

call to ttie BcreeO output r&utlneB. If-reg la saved 
and restored, in the- a)UTl ribycine-. 

S,# emt TiYlB- t*d Jf^fcfe' fi^'ld ceiitalttB tft'e affdreas the.- 

55 $37 GSWH routine which la to receive and dispose of output 

characters. When the RESET key is pressed tMs, 
field is Initialized te point to COUTl to send 
output characters to tile screen. Entering a 
Monitor Command nPc (n=port numbers Pccontrol-P) 
will cause the Monitor to set CSWL to CSWil to 

Cn. The routine at that location wll] then receive 
(In t!ie A-reg) each byte "written" through GOUT, 
which is a JMP (CSWL). 

If Che Monitor Command "0Pc" is executed, CSWL,H 
is sot to point to COUTl Instead of to C0|i!». 

56 S38 KSWL This two byte field contains the address of the 

57 $39 KSWH- user Input routine. It is set by RESFT key 

processing to point to KEYIN which gets its Input 
from the keyboard. The Monitor Command nKc (n-pott 
number, Kc-control-KJ causes the setting of KSWL 
tiS ^t.'m^R tO> ©1- rmt.tm is then ealled any 

time the Monitor or executing program asks for 
another byte of Input by calling RDKEY or one of 
tti« routines which In turti .calls iOKEY,, 

Monitar Conaraod "SKxt" results In setting 
KSWL,,H to. txilTlt tff KEYIH Itifitead of to C00^. 

58 $3A PCL This field is a save and control area for the 

59 S3B PCK Program Counter. In additlcm to the Wni Assembler 

to keep track of where the next instruction Is to 
be placed. 

Ulicn a ERK instruction is executed, this field Is 
set to Indicate the address stacked by the 65^2, 
pointing to twO bytes beyond the, BRK instruction 
executed . 
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IH'c Hex Monitor 

Addr flddr Label Description 



This field is used during Monitor commands L and G 
(Disassembler and Monitor "GOTO"). During 
disassembly of instructions this field is 
incremented as required. This field is used foe a 
Juiap Indirect In execution o£ the Monitor G 
command. 

Updating of chia, fl£j,4 M ^s^^OajsJi^hf^ i^lth the 

requires ine««iae;*In^- la ^EOiiawe «i£ii' tie- 
length of tile .in(ii'euctiptm> i&ee U^JiGW ^at 67 or 
52F.) On return TSaBJ, store A to ?CL and Y 

to p6H to acconplisii apiaate- 

iSrts fi'el^ ugsS tft^; oifl ttonlttir m support, 
of Monitor coBmar^ S and T (single Instruction 
step and Instftictlori traCe). For those functions, 
it is maintained as a pointer to the next 
instruction to be handled. 

(4 XQT This field is used as a work area for instruction 

XQTNZ step and trace in the Old Monitor. Tl:e field is 

(>l-67 $3D-$A3 eight bytes long and overlays AIL.H; A2L,H; a3L,H; 

and a4L,H. The next instruction to be executed 
(indicated by the contents of PCL,H) is moved to 
this field, possibly modified depending on 
instruction type, and then executed here. This 
fleW Is not defined in t^e Autostart MonltoE. 

60 53c AIL J^liipurpose- ifeMto* i^xrh aieai 

61 53D AtH Hay be clobbered by Iiistructibn Trace In 

the Old Monitor; see XQT above, 

Hhen the ffonitor fee"(cteiB p^riieeeslng s cotOiani, WCfBE 
tS ililtlalized to zetO. As tSie input line is 
seatMied, hex digits ate- flE«:t placed into A2L,H. 
From there they are moved alfto tO ALL.H ^nd A3L,H 
as long as MODE remains zero. When a plus, minus, 
colon, or period Is encountered, MODE is mdified 
to Indicate which, and A1L,H will continue to 
contain the value, terminated by the operator 
encountered . 

AIL.H is the primary index for the BLANK Monitor 
command, memory examine or display. 

All. ,11 contains the addend for the Houitor ADD 
command . 



Dec Hex Monitor 

Add r Addr Label Description 



A1L,H contains tbt ffllnuend ^or tlie Itonlcor 
SUBTRACT comraaiid. 

A11,,H is the source field pointer during the 
Mo.nitOT ItOVE cpmw^ttd. 

A1L,H Is one of the tWo Itidlces used in tha 
Monitor VERIFY coramand. 

AIL.H is the source field from which PCL,H is set 
on L and G Monitor commandB, and tlie Old Monitor 
commands S and T, i£ an addcess Is specified. If 
no address is used in the input line, then PCI.,il 
la the residue of the last command which 
tialnEatiied or used it. 

AlLjH is thft loemory pointer used for cassette tape 
SBfiD and WRITE Monitor apefatlons . 

H^ftttfta: r<MJttlt>e NJCTAl incrempnta All.K by one and 
Chen compares the result to A2l,H. If A2L,II Is 
less than AIL, II, then Carry is set trfieil contrpl le 
returned to the calling prop.rari. 

62 $3E a2L Multipurpose Monitor work area: 

63 .^SF &2K May be clobbered by Instruction Trace In 

the Old Monitor; see XQT above. 

This field is the receiving fleid into which liex 
data is stored from the Input area during Monitor 
Command parslnj;. Wlieo the command itself is 
encountered, A2L,H contains the last pareimeter 
entered. While MODE contains zero (until a plus, 
minus, colon, or period Is encountered) A2L,!! ta 
continually copied Into A1L,H and A3L,H. If a 
"less than" sign Is encountered, A2L,H is 
Immediately copi-ed to A4l,H and A5L,H. 

.i&Zlij.II is used to tertttlnate exainlne (memory 
display), tape write, tape -cBaa;, mno.ry wve, atid 
Taemocy verify operations. 

ft2L,R contains the subtrahend in a Monitor 
SUBTRACT command operation. 

A2L,H contains the augend in a Monitor ADD cotoEiand 
ope rati on. 

A2L,(I is the source field and A3L,H is iraintairied 
aa the pointer for t^^e Monitor STORE command. 
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Deo Hex Moni tor 

Add r Add r Label Description 



A2L,H contains the port niiniber in an Input port 
select or output port select (control K or P) 
command, 

NonitoE routine NXTAl i nc^emeflt-^ Mlj(il ^)p one -aoa 

tfym cmtiS-^ftn the result up a2l,ii. If a2l,i1 i's 
Eess than'Al'fijA then Sai'Ty Is set when control is 

M ^fSfit A3T. Mjat^'gy^pp^jft' i^-as -a^ea,!' 

,^.1 A3n Kay 'b^! ci'QlAe-E^d ^ Ifis-ttaeti.o* t&tt6 %R the tl'Id 

A,lIi,H and A3L,H are both filled from A2L,H during 
Monitor Command processing scan of the input line 
as tiescriheti atyove regarding A1L,H. 

A3I.,H iR used n;: thp. destination pointer durlnfi 
Monitor STORE command processing. 

A3L,H is used as a work arpa by the I'ej^istcr 
Display routine, Which is cal] ed by the control-E 
Monitor command, or as part of the single cycle or 
trace operations of the fid Monitor, 



ft6 $42 AAl, tlultipurpose Monitor worit aCeal 

fi7 $43 A'4H May be clobbered by Instruction Trace in the Old 

Mo.nltflr; ,See ^QT above. 

fills flMd f'^nd &5l*,H,) are loaded froaASL^H 
d\ii4~-t^ ■Wsh-M-o* ^oBHaand Processor scan of the Input 
a-ee^ 'Wl&ir- a "-^^^ ,:^4tMt^fif ■sifl^o^.-nEered .. 

h%jji 1^ t^>^ ire^tlviT^ S^^a peineer during a- 
tertito.r MPVE comnanrt fexectit'fott. 

A4L,H is the second field pointer tJurl ng a tlonltor 
VERIFY operation. 

Monitor root.Ine tlXTA4 increments A4L,H hy one, and 
then drops into NXTAl , which increments AU,,H by 
one and then compares the result to A2i.,H. If 
A2L,n is less than AlL.U then Carry is set when 
contTol. is returned to the calling program. 
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Dec Hex Monitor 

Add r Addr Label Description 



6S SA't A5L ^iultipurpose Monitor work Droa: 

69 545 A5H This field Is not wlthjn the hounds af the area of 

XQT, which. In the tlld Monitor, oArerlaye AlL 
through AilU 

NOTE: 

A5H - S45 = ACC This field Is filled from A2L,ri as described shove 
tar A4L,I1, However, the field is iipt othert«tBe 
referenced vithin Che MonltoiT, escept that AGC 
(below) is also A5H. 

This five byte field is a ri^±8t«-r sev« -ar&a-. 
With tte-^^lloi^tng -enceptlorie'i -tJjs 450Z ir^gletBTS 
0e ..sisere^ by tlie' SATO i:outi:ne -and celdsfde^ "by tli^ 
routine- 



69 


S45 


ACC 








ri 


m 




73 






71 


m 


SPOT 



S-reg Is ^tor«d ^ ^'C liy SAVE but Is never 
reloaded. 

The A-refi is stureri at ACC by tho IRQ rovitine do 
either an IRQ interrupt or eKecntioii of a BRK 
instruction. On a BRK, ertCry into the SAVK 
routint! at label SAVl is used to store the rest 
of the refslsters. The other rej'.isters are not 
stored by the Monitor for an IRQ Interrupt. 

As described above, the registers are stored In 
this area on execution of a BRK tnstniCtlon. 



ktnem •ex^e^-Cci^n ol » BMC Inst-ruction of oft 
execution of Monitor coramand CQBtlKjJ, -5, tte- 
eontents of this area are usetl ^0 *M 
^'tr^i'Stt^rs" on the serpen, 

IB'^ r^l'Stsrs ■( except s-ret) ftir^ liiads'l ftm tM^ 

-eiTBa bef-OEg juKping to the Tequestod location on 
ex&cti-tlon Of the jfe^tJ/Ci^s P. cosiuarid. 

Ift El*e-.:&T.# ;.Wnltor Step and 'Er-acft fiortjagfid 
FiMt'Iftfes, t'be registers atfe sL-ifrfed' ftere affsfc ^-a^ti- 
instruction execution and reloaded beEoCe tTie next 
traced instruction is executed. 





S4A 


unused 


75 


$i|R 


unuhod 




S4C 


unused 


77 


S4B 


i^lnuse'd 
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lltc Hex Monitor 

Description 

Random nunber field, 16 bits; 

This field is continually counted up by the KEYIN 
routine while testing for key pressed. Thus, the 
results are effectively random ae it doesn't take 
long life iSvferflow and start over. There Is no Other 
retetraiee to this field within the Monitor. 

■^ve:se these two*-feyt« flel48 -are used only by £he 
■OTi-lti-ply and-.div-Me .tTO3t:-4n«a In ttie -244 VkitCii'iax . 

the 3&(nJt«E* Wiere.forei theSfe 'etelSB. ar6" UBed 
ttMly -Ji 1&. user program aakes ase of the multiply 
or dltfldfe routines. 

The section on Data Manipulation Functions 
contains a full description of the raulclply aud 
divide routines. 

PAGES ONE THROUGH THREE 



PAGE ONE {mm-mfFi 

Pbru one is the hardware stack area. Monitor use of this area is 
only hy means of the 6502 instructions which use the stack, such as 
I'llA, ISK, RTS, etc. The Monitor does not initialize or set the stack 
l>i>[utcr (S-register) on a RHSHT or Power On Interrupt or at any other 
I line. 

PAGE TWO ($O20O-O2FF) 

I'dKf two is the Keyboard Tnpvic bviffer area. At label "GETLN" the 
X-rci'.iater is initialized as an Index. At label ADDINP the character 

i iMd ri-nni the keyboard is stored inlu pape two indexed by the 

X-rcj; 1 K t or. Tlie result is that on return to the calling program the 

i h;ir.i<-( ers read from the keyboard have been stored in memory locations 

^/</<?W and up, the last character storefl bgiiig a, carriage t^etnrn-, 

l odc $RI). 

RAGE THREE t$03l3O-O3FF) 

l'.ii;r I hriv cimlains "vectors" for special handliiip, of certain 
I III rrnipl.^ at Ltio hif.h end of the pa^e. The low end of the page, 
iliiin.nli 54^301", is fiften ased for mac-bine language subrotiElnes' 
rroin S0:)D1J through $03EF is used by DtiS. 



Addr Addr Label 



78 S4E RHDL 
13 S4F RHDH 



^81 #i Mm 

fi2 $52 XTNDi 

83 $53 XTHM 

R4 AaXE, 

fl5 |"55 



MEMORY ALLOCATION ^3 



PAGE THREE ADDRE^ TABLE 

$^m^^WW ?68-1^7 Hot used 'by tii^ '■MotiixSc .. 

^5F^f|^3i'l' lif^S-IE!^*' Itie iatost-aPt Sonlto* ikbs- tills, l^iat.lon -as, the 

$03F2-S03F3 15!1.?-10U This Is the RESKT (Soft Entry) Vector (address) 

used by the Autostart Monitor, as described In 

the section "RESET Interrupt - Aritaat.att 
Moni tor" . 



S03F4 HJ12 Powered Up Indicator: if the Rxclusive OR of 

"SA5" with the contents of S33F3 ia equal to 
the contents of $03F4 then the RESET (Soft 
Entry) Vector is consideriid valid, otherwise, a 
RESET interrupt will cause the Autostart 
StMiitOT to go through power-up ialtiallzation, 
including boot of DOS if available. 

S03F5-S03F7 1013-1015 Reserved for APPLESOFT ("&" vector instruction), 

503F.a-S0:3E;A HJl6-lgia Cojitioi-y Vector <ln6tmfct±Qia. 

'0-^7S-0'^a Mon-riasltable Ihterrupt Vector tinStructlon) . 

503FE-SSI3iT 10.22-l?r23 TRQ latetmpt VecEor (address). 



PAGES FOUR THROUGH SEVEN & ELEVEN 

Address range $<i'i<f9 through S0^FF is the priinary text and low 
resolution graphifis display area. That is, screen display hardaare 
dlsplaj^s on the .stsreeR the infonaatio-n stored in thi.a part Qt iiKiSi>Ey. 

iteer I'iftt genefSi Tjt^ftgVSffi ot" data storage. 'However, ^00- 'thi'6a0%- 
•is tkg seiSOTlda:?^'' t.ex'C and low resolution graphics dlsplajf- af-®^. 
¥$KEiti& -162^^ irfth any value, the screen display hardware Caii bs 
directed to display to the screen this- secondary display area 

instead of the primary display ssiia. iEQlCE -16300,0 to switch back to 
the ptlraacy display area. 

Although the hardware will display to the screen from the secondary 
display area, the Monitor does not support the feature. That is, the 
BASCALC and GBASCALC rouLlneH in the Monitor convert the line numher 
Input to the routine to the appropriate Eiemory address for the primary 
display area only. Use of the secondary display ar«a Is described In 
the section "Secondary Display Areas". 

Contiguous screen lines are not In contiguous Eiemory locations. The 
characters on a screen line are in the same sequence In netnory as cm 
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thi> screen, but the lines are mixed in a manner which sioplifles the 
hiirdwnre display to the screen. Tlie following table Indicates for each 
line the address In nemory for the leftmost eharact^E of the line In 
hiilh Lhe primary and secondary display areas. 

The liASCALC routine In the flonitor computes the memory address for the 
line number input to that routine In the A-reg. Using the letters Co 
designate bit positions In the input line number, the following 
indteates the result of the coBiputataion: 

Input line number (A-reg) a00ABCl)E 

Me,ai9r3? M4r'$%s. (BASH BASI;) 000.0^,1CD fA^ABM^i 

This can be' 9^1^ta(#6'|!S^,I? ■G^M;g(i, using "modu-1.^!'' arl-.tlStiifttJX i« 
place of the ASBb and <Ms «r machtne language- ItBe^ Jtwn^ex 

A:)DR-I024+23&*<(i/2) MOI> 4M128*Cl. MOD 2))+40*((l/&)MOI) 4) 



SCREEN MEMORY ADDRESS TABLE 



Line 


Primary Display Area 


Secondary 


Display f 




Deciiaal, 


He? 


Decittal 


liex 





1024 


0400 


2(348 


0800 


1 


1152 


0480 


2176 


0880 


2 




0^00 


2304 


0900 


3 


1408 


0580 


2432 


0980 




1536 


0600 


2560 


0A00 


5, 


16b''i 


(J680 


2688 


0A80 


6 


1792 


«;00 


2816 


0B00 


7 


1920 


0780 


2<)4<^, 


0B80 


8 


1064 


0428 


20!i8 


0828 


9 


1192 


04A8 


2216 


08A8 


10 


1320 


^528 


iyu 


092a 


I) 




mp- 


■2472 




12 






2600 




13 


\m 




2i72i8 


0iSA« 


U 






2656 


0B-2S 


15 




07A8 


2984 


0BA8 


16 


1104 


0450 


2128 


0!i50 


17 


1232 


04D0 


2256 


08110 


Ifl 


1360 


0550 


2384 


0950 


19 


UR8 


05D0 


2512 


09D0 


20 


1616 


0650 


2640 


0A50 


21 


1744 


06Di;i 


2768 


0AD0 


2'2 


1872 


0750 


2896 


0B50 


23 


2000 


07D0 


3024 


OBRO 



ll Is also inleresting to note that although 24 lines of 40 characters 
cdnpnlc's lo ''60 bytes, the memory area described above contains 1024 
bytes jx^r display arefl. The significance Is that sone of the bytes In 



pages f oi-ir Chrovigh seven are not displayed on the sc reen - Tliesc by L e:^ 
are eight groups of eight byces each. This space lias been set aside or 
allocated for use by peripheral controlJer cards In slots one through 
seven. The following table shows the allocation. 

Hlcuse of these locations can be easily accomplished, with potent 1 .1 1 I v 
serious results. Note that it an Image of the screen is generated 
elsewhere and moved to this area in a block, the locations iflentJfled 
belou will b-e irtodlfied. If a progrHm Is loaded [rom tape with Che 
Monltoi^ command inmmn.nn.nnR, and If ranma is less than then the 

■t^y\»S 't« iSl^ !C«#.it(^jlg talkie' ,*dll be loaded from the tape. If m 
atE.mi^$ $3 ta^e. to save, £fte, screen area to digit, and later (11,6^ tt tS 
th$- sec^en ftcea-t. r«swt*S ^san confusing, ^fee- Bisk Bon^rdl-lec featdj 
and possibly some peripheral device interface cards keep control 
Information in thfesie; areas. For example, doing the above mentioned 
BtOAD £ron diive 2 when the BSAVE had been done fr«!ii drive 1 will 
result m ■l;t;ie disk switching bade to drive 1. 

The "Reference Manual ^r^eatea than (me. oust; "be- sniiSe -ttiSt ^f^rs^i 

mv&mi Ae.ti>at%tji^ ■fie.iets! mim w^m^. nmt aM to mote 

than Violation raf tlie tiftfes £a the 'felloiKi ftg ta-Ble vill Be Bie 

unfortunate rfeaulc if this caution is mt observed. 

PERIPHERAL CONTROLLER WORK AREAS 



Common 




Slot 


Slot 


Slot 


Slot 


Slot 


Slot 


Slot 


(any/all) 


I 


'2 


3 




5 


6 


7 


Decimal 


Ilex 
















lU^i 






047A 




047C 


047D 


04 7E 


047F 


1272 






(J4FA 




04F(; 


(J4FD 


04FE 


04 FF 


U(J0 


1578 




057A 


IJ57B 


057C 


057D 


057E 


057F 


15Z8 


(^5F8 






05FB 




05FD 


05FE 


05FF 


1656 


9678 


3679 


?67A 


067B 




067D 




067P 


1784 


a6F« 




06FA 




■tee 






191Z 








mn 










ij)'?r8*" 






$7r& 











* l.ocatiQn 2040 (S07F8> has apeciaJ sisnlftcBncei 'iMtS locdflen should 
be loaded irfth $CN, where N Is the slot number oE- '&0L active 
peripheral, whenever an interrupt may occur and the KOm/PROH expansion 
scheme Is in use. This is necessary so that the return from Interrupt 
software used allows the proper peripheral card to resurae operation. 
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INPUT AND OUTPUT 

The de'?-&iil* e^ier^-tion lb* s'caj;^ea- U A- M^'t^ltTis -^■^ise.i. '^ata 
Is enticed output, at- tfi# feptom. .Of ficE^R. and' ^1 aWse 4a 

shifted up line by line until 'tli6 oldest InfbMation ilisappcCre olS 
the top of the screen. With a little extra work In the user progran, 
It Is also possible to use the screen as a formatted display. 
Following is a description of the effects of that type o£ use, and 
some suggested solutions to the situations encountered. 

Characters generated by the user program for display on the screen are 
handed to the Ilonltor one character at a time. The screen output 
handlers check for control character vs. display character, and operate 
in accordance with what they find. For example, output of a carriage 
return character or line feed character while the cursor is on the 
bottom line of the screen will cause a scroll operation to take pt.a^te. 
I£ the screen is being used with a fornat instead of as a scroH- 
dSVI"c^* tM'i itJi^ :^i^gr-W can jSasliy- ayold, ptttpwt, f$ a. car^i^*, secMTrm 
p-t- feed ^Sie« '*fe. wpgoc is- on tliB? "bot%Oni *l-fifle, of Che -Seroea* 

The nasteAt tray ^T- t^e user prOfi"aft !t?a Ifead, iJvEormatlon from tbe 
kej-btjard ig' eall tJie Monttor tbS ^r)i%«. Wiere It will read I^, a 
line (up to A carriage returai befbtie EeE«*«iii&, coRtEtjl (o tlve cabling; 
program. When tbia IS done, tbe liipJij:- IrIbPe^Ito- Is' .slwayB available 
at the same place in memory. There j^,, hOiwMT> 9 e^OS'lt'&t bettfeen 
using this type of a call and using the screen as a format type 
display. While the Monitor is receiving the keyboard input, it 
"echoes" the characters to the screen at the current cursor location. 
When end of input Is aigri^^le^ by a carriage return, the Monitor clears 
the cursor current line from cursor to the right end of the line 
(within tbe Scroll Window). Tlius, the user pro^rara must make sure that 
before asking for input from the keyboard the cursor is placed where 
there IS no plgnlflcant datg t(> the right. 

It is possible to divide the screen into scroll area and non-scroll 
area. Many complications arise from this method of operation, so the 
reconraiended solution to the format display problem la to leave tbe 
screen full scroll and avoid scroll services when they are not 
desirable* 

The entry points and ■ flasltf iecS f^gf tiisii^- SCKill ana rmt-BfCtoLl areas- 
will be foujid the- .section on Text Output Without the Scmtl t^ft^ow. 

KEYiOARD INPUT DIVISION OF I^OR 

The Monitor routines supporting keyboard input are designed to echo 
Che keyboard input to the screen (through COUT) at the current cursor 
position, and store Che entered characters In the keyboard input areia 
(S0200-502FF) for the convenience of the calling program. The 
execwClng pteigfiaia may position tbe cursor anywhere (in tllB iffc^o^l 
Wlralowj liefo*^ .c^ltng the Monitor .kejboacd input ,r<w,tlti^, ■9ft-«nSry 
of a earriaKe ^retuijii £rom the fceyboa*a>, tbe Mbriltor "fey'tidarS iitpui 
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rouclnes will cause return of ciintrul back to the calllnfi pro);i"iini w[ I li 
the character count plus one In tho X-reglster and a carclap.o return 
in Che input area as a terminatcr. The prdgram need ^ot look into the 
screen refresh memory to detennino what was entered. (Note; The Y.- 
Register begins with a zero, so that if five characters are entered, 
the X-Reglster will reflect 4, although the actual value returned 
Will be 5. X la ltvcrenente4 for the carriage return, as ■well. 

The routlnea described below are included In the address table. The 
followll^g SBCttoa,, "User Program Calls describes pr.ogcain Setiipa 

for ealllsjft ^pe. of Eh»sK •fihf»:f painty. Be>? aafitaas-,, + 'S^citml 
address, and. - Ueclnial address are given in bracTcets beneath eacli 
routtne. 

TABLE OF ROUTINES 



Routine Description 

^^tffe Entry at this point causes output of a ea.rcla^e rftturn 

[SFD671 (through COUT) before f;oins to OETiff to Utlte th^' prompt 

[64871] character and read the data. 
[- 665 J 



GETLN Entry at this point Is with the cursor ijroperly positioned 

[SFC6A] (CV, BASL.H, and Cll) as described in the section regarding 
[64874] Text Output Within the Scroll Wlndcsf. 
[- 662] 

GETLN prints the prornpt character and initializes X-reg for 
indexed storage of the input characters into the input area. 
Control Chan goes to NXTCHAR. 

NXTCHAR This is the €6p pSlui: 1ft the chara.atee I-jipuC loop. RDfifJ^ 
[SFD7^] l9 called to get a character Into the i-reg. On retimi ih^ 
[ft4885] Ar-t.eg 16 tested for presence of the crtntrol-U (rigWc on 
I- 6511 -the aroyboard) and 1£ it Is iouffid, the A-reg Is theft lb»St^9 

fv'm the s-cr^n IPefer'^EiK me.mbty CCbaSD.Y), assuming i^st the 

Y-reg cBOtalna the saiSe- wsiwe as CH. 

If the A-reg value is SE^ or greater, the leWer case letter 
la converted to upper case by AND with The character is 

then stored from the A-reg to the Input area. 

If Che character is a carriage return, CT.KEOL Is called to 
clear to blanks the rest of the window line, and then a 
conditional branch transfers control to COUT so that the RTS 
exit of GOUT will return control to the calling program with 
the X-reg indicatlnfi Che input character count +1. That is, 
the input is in memory locations $0200 through §0200, X where 
S0200,X contains the carriage return. 

If the character is not a carriage return, then control is 
transferred to the HOTCR routine for display on the output 
deuic!^, and for interpretation with regards to control 
character affecting the input line. 
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This routine receives corttrol with the character of interest 

in fIN.X). Tlie current setting of INVFI.G is saved on the 
starlt, while INVFLG is set to SFF so that the character 
"echoed" to the screen will be white on black. COUT is then 
called With the .gharact-er In the A-re8> 

On return from COUT, ItiVFLQ is restored from the stack. The 
character at Ifl.X is then tested for either of two special 
keys : Backspace (left arrow) or (line) Cancel (control-X) . 
If liackspace, go to BCKSPC. If Cane: el , go to CANCEL. 

If (IN,X) is neither Backspace nor Cancel the value of X-reg 
is tested to determine whether the input area is full or 
almost lull. If there .acs imre .than 247 cha,ratt6i:,s In the 
Input area, a x^ll -feo' "S^tt is Mse^ W etgnal Co Che operator 

that' the 3*ea 'H ^iM'&t fuii. 

After or without the margin warning bell, this roufilsft gets 
control. Here, the X-reg la incremented to point at ¥be 
next location In tHe inp.ut area t() l)^ Jil,l,pd.., If, hqwe-Ver, 
the result is overflow to zero, then entry of the Cancel key 
is simulated by falling Into CAHCF.L. In the normal case, 
after incrementing the X-reg, control goes back to NXTCIiAR 
to conrihue with chacacter inptit and line building. 

This routine prints a hack-slash through COUT to Indicate 
ttie action taken to Che operator. Control is then passed to 
CKTINZ Co initialj.z-e for Jeiitry of a new Input line - the ,old 

ore is gone. 

Oil encry to this routine, the backspace character has 
already been printed through COUT with resulting backward 

movement of the cursor. If the current value in X-reg is 

zero, control Is transferred hack to GETLNZ for printing 
prompt and re-lnltlallzine for line input. Otherwise, the X— 
reg is decremented idth cmtml to HXTCKi^iJ tcr resume 

input of characcei^. 

UjIs tpntriW 'M^l^ to tttS wratt: jj^si-^ciec placed 

!int»' the k-KS^i: {m r-etiiro^^, ifc is ^ound 0tst the Escape 

"bmh 'pp^f«gd,, bM-S: |<«j'ElTtg' ^a^s .-thfe ..^proprlate 
T-ont^ne f^C rea^i-t^ cW nest cliaracter and' performing the 
r-equepted' '^i^ f!0t2C5ftiV'. -TS the old Monitor^ GpW>!0-i 
la passed to the %SCl routing for this purpose, after a jSft 
to RDKEY to read the ne>:t character. In Clie Autostart 

rionltor, detection at RDCilAR of an Kscape chstacter transfers 

ciintrol (via ESC including RDKFY) to ESCMEW, which has the 
capability of handling multiple escape functions after a 
single depression of the Escape key. 

After ;iny requested escape functions have been performed, 
control returns to RDCIIAR as if there had been nO 
1 nterruRti-on. 



Eautlne 



Description 



RDKEV This routine picks up and saves !n the A-ceg the character 

|gFD0CI from the screen refresh memory area at GASL,)[,CI1 (leavlrj; 
[64780] the v-reg filled \jith the contents of CIl). It then ebanses 
[- 756] that character in memory to blinking to Indicate current 
cursor posltlotii. 



KEYTN 
I SFDIB] 
[64795] 
I- 7411 



ESC 



[5FBA5] 
[6442i ] 
[-1115] 



This routine asks for the next Input character to he placed 
In the A-reg by doing an indirect jump "ula KSWL.H, which la 
B*irEiall}* iKilntIng at KEYIN. Return Is therefore Co the 

This i$ the t^6-t!^ '**l:fcft gft^fe the next, liiput key front ttte 
keyhoard hardware*- fhere^' are tm retlUlVed actions and two 
extra actions, t^feeir by ^his i^:mtine-i Bie required actions 
are feiailt'ff 'tfee Si^oati -iioEsit -btfff^ <swer and over again 

liiltH it la d'et«l?f(llii^ flise.s^t* ;Sf- the bit) that a 

character haS Irideea isee« tead. In tftis case, keyboard Input 
buffer refers to the gi00 byte buffer at $200, and not to 
the location at SC000. The sign flag is set or not 1^ 
checking the status of the value at SC000. If that value Is 
positive, the routine loops back to KEYIN. If that value Is 
negative, the value of SC000 is pickerl up and the keyboard 
strobe is referenced to prepare for the nest keyboard input. 

The auxiliary actions taken by this routine arc first, to 
count up the random number field, ignoring overflow, and 
second, to restore to the screen area the character modified 
by the RDKEY routine to remove the blink. Tliin restore Is 
accomplished by storlnj; the A-reg at (BASL),Y, assuming that 
RDKhY loaded it. Tliis i^; a(;coinplIShed before the keyboard 
register ts read into the A-reg. 

Return to the caller (of RDKEY) Is accomplished by an RTS . 

This routing is entered fron RDCl.lAR if the A-reg, is fQund to 
ceataiii the fiscSjie, T?ey, cote, -ft cea>BaS» the A-re]g .witii ■» new 

»3 perforn the requested"' sliiglfe .ffflH^ti&n". In cite. ^HiuaRCat'f 
JlOnltQt, ESCHEW la called to gerfiS-Jgn- tfefts reqM«iS.e^ fiCRWti'sJtt^. 
Xn either case, ESC Is positioned sugIi tirat tWe vfnich 
t.a.tjnlnates Escape feey processing returns, control to liDCHAR. 

This routine exists only in the Autostart rionltor. It is 
the routine which supports cursor movement without data 
transfer; tlie Escape key functions I, J, K, and tl. If tbp 
key next pressed is one of these four, the appropriate "old" 
function (Flscape functions C, B, A, and D, respectively) is 
called. On return to ESCHEW, RDKEY is asain called to get 
(and ope-rate upon) the next ctiaraCter ICoia the keyboard. 
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R routine Description 



If the key pressed Is not I, J, K, or M, then ESCl Is 
entered by JltP instead of JSR so that the RTS will retura to 
the caller of HSCNEW Instead o$- to- ESCHEW. 

RRCl In the Old !1onItor this routine Is called by the RDCilAR 

I $ KC2r ] rout ine if the Escape key code Is f oun.d in the A— re^ by that 
IdA^'Sfil routine. In the Autostart Monitor, control Is passed in this 
|- 9R0] case to the ESCNEW routine which then calls RSCl or juraps to 
it depending on i^lch key Is pressed next. 

ESCNEW translates I, J, K, or M to C, B, A, or D 
respectively before calling ESCl, which returns to ESCNEW. 

If the key Is other than I, J, K, or M, then ESCNEW JMP's to 
ESCl with Carry set, to have Ctia appropriate function 
perrorm,ed.! In this case, the nfext RTS will return control 
to the RDCKAR rotitln-©. 

tftien 'EfSfE'I, is. c^Ilea-, tfife eot3#6iit"9' irt^-^A-'reg- X-kiiA the 
e4ttpti(jn; that SSCt.Sy" ts "a"^^''} ■i-a^iG.a^i^p -.the actie^i to be 
talisih^ ifeanfctifcl t4 EafajtfeEe^«^# '^feiS^tlix'ioiial bran'chj to thp 
te>pm:PX^.stm- SptolX ^a&s^, §eimi^P toitfl'i.e to uro^e' t&e- c^TSpr 
wi'tRout transfet-riag data,- far cleaf all ,oit <if 
sateen, or Eorne eombltiatl^rn ,Qf these. 



CALLS TO KEYBOARD INPUT ROUTINES 

Tilt" following paragraphs descrlfie how to set up for calls to the 
various entry points In the Monitor for keyboard input, and what the 
results will be. 

TABLE OF KEYBOARD INPUT CALLS 

RiiutlpB DeBcrlptlon of Set -Up. 

CKTLNZ Mrlts eart.i^ge jfest-nvii- artd'. prompt 'CHaracteif, '-Vhea «ea4 a M'ree. 
SeE-Up: 

X-reg, !-reg, and A-reg are las ignl'f leant. 
CH Is Insignificant. 

CV sh(Jiii4- Splint to the line In the Scroll Window tAvere 

Input Is to begin. 
BASI..,>! IB itisigivlf leant. 

Kosiil ts : 

CR Is written, scroll takes place if appropriate. 

I'rompt character is written through COUT. 

Keyboard is read character by character. Each character 
la placed at SC2a0,X and X Is then incremented, 
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RottCtne 



Description 



Each character is "echoed" Lo the screen at cursor 
position and the cursor Is then advanced. 

£ln reading a carriage returnj control la retucitEd to 
calling program. 

On Return: 

A-reg contains a carriage return code (S8D). 

X-reg contains the number of characters read before 

carriage return. 
Y-reg contains contents of WNDWDTH. 
Location $4)2^0, X contains a carriage return. 
CH contains Zero. 

CV contains line number, current value. 
BASL.H contains memory address "foe CV, WNDLFT. 
Window line 1b "blank to the right o£ the end of the 

eckoisa Input. 

GETLN Write prompt charafc'ter, Cbeti fead a; lliie. 
Set-IJp: 

X-reg, Y-reg, and A-reg are insignificant. 

CV and BASL,K should he compatible, pointing in the Scroll 
Window. 

EE IndlQ-aC^ iSiere- m that lirte the prompt character Is to 

>e ^Jaced, to fe' foili^ea' tfee echoed key input. 
Llite ad^drees at Miich input is tf> tiesiii, wst he lu 

BASLjH. The Line number £n CV wll.l be 'QfllcuiatB^ araf 

set In BASL,,li after a carriage return has' been Entered. 
Eesults : 

Sane aa above for GETLNZ, witlj' nstt^A aggKs'ejJfti^ft. 

Ob Return: 

Same as above for GETLNZ. 

NXJCHAR Enter herfe to bj^pass print of prompt character to the screen. 
Set-Up : 

X-reg should be zero to begin storing input at S0200. 
Y— reg and A-reg are insignificant. 

CV and BASL,S should be compatible, pointing in the Window. 
CH indicates iitiere echoing of keyboard input is to, start - 

Results : 

Same as above for GETTjN. 

On Return: 

Same as above for CKTLN^^. 

Note: For all the above. Escape key functions are supported as 
described In the reference material for the tlonitor you have installed. 
Also^ Gontrol-U (right arrow) is supported. When that character is 
recogsvlKed in the keyfetJacd feiiffer-, i'C is ;i^l'a"c^ it the A-regtster by 
Che contents of the scteen memory at the current curaof p>aitlon. 
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J*ead single character thru ^Wt: return to caller in A-reg. 
Set-Op: 

X-reg is Insignificant, and will not be clobbered. 
Y-reg is Insignificant. 
A-re^ is insiignificant- 

CV and BASL,H should be compatihls!, pointing in the 
Scroll Window to the line where input is to begin. 

CH indicates the horiKonLal position in the Scroll Window 
where cursor position will be indicated by blinking. 

Result s : 

The screen character at the cursor position (BASL),(CH) 

will be set to blinking until a key is pressed. 
If the Escape key Is detected, the appropriate routlneiS 

will be called to handle the requested function. 
Cursor right arrow (contrgl-^J: will "be returned to 

cal.liJig, program, not. t^S^ t^tSnts of the scree-n at the 

crtrsor. 

Cursor left arrow key Cc'onC r0l-H) will he returnea to tbe 

calling program. 
Characters read from the keyboard win -not be Stored in 

the $02<i^ area. 
Aftpr the character is read, the blink will be turned off 

at the cursor position, but the key just read will not 

be echoed to the screen, nor will the eursQE (Cil) be 

advanced . 

Cancel Input line (control-X) service is not defined 
as the data is not being stored in the 5020^ area. 

"No special note is taken of carriage retiirn, because Che 
rest of the Monitor KF,YIN Koutliie is not called. It Is 
up CO the calling program to take appropriate action on 
entry of a carriage return. 

On Return: 

A-reg Contains the value of the key pressed. 

Y-reg contains the contents of CH. 

X-reg is not affected by the routines called. 

CV, CH, BASt.,H will hav«' ch^nge^ only if an Escape key 

^^cEi^sti 'iia's heeii .in.liii^^fe.. 

Read, sia^'is. charaeter 'thru l^WLj return to caller in A-reg. 
SEt-tJp: 

X-^r.e^i ■t-r^,g<, and A-r?3 are Inslgnlf leant . 
GJ/ .BTio iJASLjII should he compatible, pointing in the 
'■S'creiJ Mndaw. 

&i indicates the horizontal position Mfvere the -rursor -will 
he shown hy blinking. 
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Rout 1 ne 



Resu.l ts: 

The ^-.haracKer on the screen Jit the cursor position if; ■;el 
to blinking. 

KEYIN routine Is Riven control via (KRWL) for physicril 

reailinc, of tht> keyhiiard. 
Return (RTS) In KEYIK returns to the caller of RHKEY, not 

to tTie SDKBY routine. 

On Return: 

A-reg contains the character trom the keyboard. It nay 
be any charactefj^ ineltwd'ii^ BsSS^, carriage return, 
right or left aTIOKj- B"^- any ofcli^i" control character. 

Y-reg contains .BQi«.ejita 

The chara'cter' in "tW ^"reea at tte ■cufSa't ^si.KlOn 

haft ke'SHX ■rastomfl to iAl^t-tWer it w«S before It was set 

if): ■feTit&F % 8Sia;Y. 

fi? i'S ueeil tD.Galculate the new line. 
BASL.H reflects the recalculated address. 
GV remalrta unchanjied. 

KEYIN B^ad slr^ie chAracter Ivrm "keyboard; re-turn to caller in A-reg. 
Sct-Up: 

K-rcj^ is unused and unaffected across this routine. 
A-rcfi LEiiuit to this routine Is what will he stored IntO 

the screen firoa at the ciirKor position (BAHI.),V to 

remove, the hllnk condition after a key is pressed. 
Y-reg is set to he used to store the A-rc;^ into the screen 

area to remove the hlink at (RAF;T,),Y. 
CH and CV are not referenced, but should be appropriately 

set* BAEIf.H ate us^fl as described for A— reg and Y-Keg 

above- 

Results: 

■Qu i^efciira to ttfe' eaXi^'f )■■ loiiTy the A-reR has been chAtiged. 
It contains the input from the keyboard reRlster. 

KEYIN ROUTINE REPLACEMENT 

There are cases In which it is desirable Co replace the physical 
keyboard Input rouCtne with a routine which either r(=ads from the 

"K^yBtoia iie^flF^iC^SSeS 'tUe i.l^ttt, .isr- sets Cho information to feed 

to the reading prosy^''^ from some source other than the keyboard. The 
requl remenCfl <3£ sufiti a program in replacing the KEYIN routine are 
described below-. TlaclhB Clw p-rppi-«m/wutine into, effect is 
aecompll-pti^i^ fey et^'rinS the ei55,ry t^i^t: iH :^Ij,-R. 
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I'll.' reiilacement routine should manage the following resources as 
1 udl caccd . 

A-reg Store tlie A-reg at (BASL),Y, then load the A-reg from 
Uhat'evec Source ifl to be used. 

X— ref> Hast be imaltered. Save on entry and restore ^fn. exit If 
it BWat be used by the replacement routine. 

Y-teg .Uisg a* iwHtfited above for A-r«R- 

tet *b« changed on return Zim, is^nt&at^^ etttry, 
■so 'sa'm and restore If it must be used athsrwlsei t^hlB 
cautldfe -iS; Jto'f required, however, if- t^j^, BOtti^i^ ;<if the 
input prevent-s Sacape key and right acrfflfl. 'itint bfti-ng 
encere^. In such case, the Y-reg is eitpendafele . ) 

Cil These are all used for echoing the "keyboard" input., 

C\f so the replacement routine should either leave thero 

BASI.jH a.lon.c or inaai^ulaW them la an appcqprlate Eianner. 

KOTF.-. On replacing the pointer to KEYIM at KRWL.Ii, It Is generally 

safer to pick up and store cho current contents of KSWL,H in a 
save area berore placing ths-; address of your routine, and then 
restore KSWL,H from that save area when taking the replacement 
routine out of service. 

NOTF,; If you replace the contents of KSWL,H with the address of your 

routine while ua.ing DOS, expect the unexpected. DOS uses both 

CSWL,]1 and KSWL,II, and periodically restores them to app.ear the. 
way DOS likes to see tlieui regardless, of cutrent coBtents,. 

Depending upon yo.ur app4.igajyt&ftv -t^f ^ ^ 

ce.p-I«ce 'ijQth jMjiflt-eTiS m -a fcegmj^jry hasXe m tt^t ■ecticr feo t?ve. 
sci^een «ill aec f?s^ t:iiTm0\. 6es> ' "But' t^eniber tO' repair '.both .as 
soort as possibl*. 

KEYeOARD INPUT MONITOR ROUTINE 

Ttii-rc are many points in Keyhoard Service Which a user prograia could' 
ufii-'fullv coll. However, because they are generally different locations 
In ;i continuous striiiR of instructions, and all Instructions after the 
l>ij I ut of entry will he used, sections of this table of addresses are in 
Monitor seqoence rather than in seqvience by potential usability. 

NoLr lliiit once the Monitor is jumped to at the specified point, all of 
till' initialisation described -if tor that entry point is also perf QCiaed, 
TIiIh is Iniplied by the at the ond of each function description. 
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ADDRESS TABLE 1-CHARACTER INPUT 



Futict i'on 



HeX 4^g'c -Oee Horift'or Rettlstera 
Addr Addr ,\dile Liihi^l lliv^i:i-oyi--il 



e«il RBEEI! So. next character 
Into A-reg. 

Compare to S9B (Escape). 
If -• BR C{) KSe to teali foi- nfext 
character and do Escape function. 
Else, RTS. 
Set screen to blink at cursor 
saving original character in the 
A-reg from (BASL) ,Y & 
-Tuwp lildlreet (KSHL) to YMtfi 



FD35. 54821 -715 RDCHAR A.Y 



FD0C 6i78l3 -756 Ri;Kt:Y A,V 



FB18 ,64792 -744 



Increment random number at RNDL,H F51B 
while polling keyboard register. 

Store A-res to (EASL),Y (clear VOId 
blink set hy mvv.Y routine). S 

Load A-reg from keyboard register EpZ& 
^nd Ql«ar keyboard strobe and RTS. 



6^795 -74L KEYIH 
6480& -730 
-728 



t'CZG M556 -9R0 ESCl 



OLD MONITOR ONLY 

Call RDKKY for Ksc^pe key service & FD2F 64S15 -721 ESC 
Call r.SCl with character In A-reg ED32 64818 -718 

and Carry set to do Indicated 

function- Return B 



jSltEOSTART MONItOR fflJLV 

Call ItDKEY fo-c gac^e Itey s^tvic^. S FD2F 
Call fiSGKSW ^a.tti tlim&iftC&T*' ^te.^ f^t 
anii ^lajety- do mdicat^a. 

Eonc'ctijit.. IfeEurn. from Esd^T^ 
processing Is to KDCHAR (al>ov«). 



64015 -3^1 



ESG 



A.Y 



Ij'sing c>iarac;ter In A-reg, witK 
Carry get, BR to routine 'f^T 
Escape key service. 

@ HOttE ele^r scroll wiwdos 

A ASUANCE cursor ripjlit 

ft g> cursor left 

.4- W .cursor ilfKm one line 

D DP cur'sor up or« lin« 

E CLREOL clear to end of liae 

r CLREOF iilr to end of window 

cither Igdorei RTS 

Set port If (keyboard) for input. FE89 65161 -375 SETKBD A,X^Y 



A,Y 
A.Y 



A,? 
A.Y 
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Funtt Ion 



Hex +Ut!C -Bee Monitor Registers 
Addr Addr Addr Label Destroyed 



Set Carry flag and JMP to ESCl 
to handle Escape key functions 
A, B, C, 1), K, P. 

Handle Escape key functions 
I,, J, K, !i. Translate 
bj. hi G- aad mil essMh,! 



Escape key processing entry porlalt. 
If A-reg contains I, J, K, it V 
then go to EECNOTv to translate 
and handle it with return to 
ESCNEVf. Otherwise go to BSCOUl 
to handle this entry atid exit 
from Escape mode. 



FB97 66407 -U29 ESCOLB A,Y 



FB9B 6Mn -1125 ESCNtM 



FBA5 64521- -IIJS ESCNEVf A,T 



HASL.H 40-41 $28-529 
KSWL.tl 56-57 S38-S39 

ADDRESS TABLE 2-LINE INPUT 

Logically speaking, the place to start below Is "CETLNZ, but the 
sequence of presentation here Is the sequence of instructi^irtS In the 
Monitor becaiiKe of heavy use of "fall Into" next code segment. 

Note that once the Monitor in jumped to at the specified point, all of 
rlif ini t iol i nation described after that entry point is also performed. 
Thi^ is Implied by the & at the end of each function description. 



function 



Hex +Dec -Dec Monitor Registers 
Addr Mdr Addr Label Destroyed 



FD4D 64845 -691 



Echo keyboard input thni GOUT to PD3D 64829 -707 ITOTCR 

the screen, from IN,K, with 

INVFLG terapotrarily set to SFF. f. 
Pick up character from IN,X; 

1 f 5fifl goto BCKSPC. 

If S98 goto CANCEL, 

If X-reg (inptfl; IrBjeX, ^. 
tUan 5*^? fall iiit^ 'I^is. 

fiiiffe gan^ SfXlCttl,, iyjs^ss fell,. 
SoMai toeU If "X' ifflUfeates 24*+ 

dirRM.t cftflrac.tera. 

If X not Kero goto NXTCHARt 
If X-0 fall into CANCEt. 



PD5G 648^ 
FD5F .S4863 



-67/a. 

-673 



tJOIGR,!. S 
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Function 



Ttex- t-pei: -SM M^MteSr HeKlsters 
M^X *ijir Ijfiliel Destroyed 



Load 5DC (\> into A-re^ - 
Backward slash indicates line 
input cancelled. S 

Call COirr to print A-reg. 
Then fall Into GETLNZ. f, 

Print carriage return thru COUT. b 

Load PROMPT into A-ros- S 

Call COUT to print A-reg. S 

Load X-reR with $Sl for passage 
thrvi backspace operation. 

If X-il goto GETLNZ to start over. 
Else, decrement X— reg and 
fall into NXTCHAR. 

Call RDCHAR Co get next character. 
If character received is ctrl-U 

right arrow) pick up the 
screen character from CBASi;j,;Y 
Ed j^erRlsac-e It ijj. the ft-reS* * 

If i-reg grssater than- iw,- eW.n 
AND against $DF to maT^e It 
upper case. Si 

Store A-reg to input area at 1N,!X. 
Compare Co carriage return. 
Coto NOTCH (above) if not. 
Else, rail CLREOL to c3ear the 

rest of the line, then print 
carriage return thru COUT, 
usina RTS from that function to 
accomplish return to taller of 
keyboard icput . 









CANCEL 


A,X,Y 


FD64 




-668 






yndl 


64871 


-665 


GETLNZ 


A,X, Y 


FD6A 


64874 


-662 


GEIXN 


i,X,Y 


FD6C 


64876 


-660 






FD6F 


64!f?5 


-&57 




A,X 


FD71 


64881 


-655^ 




A,X,V 




64885 


-651 


NXTCHAR 


A 


W%' 










FB84 




-636 


ADDINP 





IN =S02H0, keyboard input area. 

INVPLG is at $32 (50). 



OVERVIEW— TEXT OUTPUT TO THE SCREEN 

The highest Level of support in £.1^, "J^^nitor for fcpxt Wtput to tlie 
acre^ is ^rell device support. Iti addition, tlie Moeltor contains 
many cOApoilients which support use ^i^ the ^reea (n a Eormatteii manner. 
Because there nre so many ways to wrftp Cestt re the screen, tbe topic 
0cr,een ^tpyt liaS- tee-o divided littts the follGwitig sectlQJisi 

TE^ OUTPUT WITHIN THE SCROLL W'lNIKJM' 

describes the normal manner of text output, defining the fleide in 
page zero which are u^^ed to control this function, and vftilcli are 
used in the descriptions in Che following seccions. 
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SCRRKH FORMAT CONTROL 

Idenclfics the entry po ints by means of wliicli display operation 
(full text, full graphics, mixed LORES graphics and text). Scroll 
Window setup, and character display mode (black on white or white 
oil hlack. or bllnklngj are est^hlished or nodifled. 

SCROLL WINDOW DATA flANlPULATIONS 

describes Monitor calls vflilcb clear all or part of the Scroll 
Windoh", set paj^fi^ i3f " the wliSaaw to sooe user specified value', (it: 
Caii«e cowiit'ieiB^l W uritSonaitlonal scrolling of the wlndo>r. 

CSn<50R POSITION CONTSel^ 

describes the ways and means o£ moving the cursor ["elative to -'tts. 
current jxisicioa, or nio%'lT[g it to some loeation independent of Its 
current position. 

GF.NF.RAL TEirt" f(j ^ BC^EK 

describes tbe Hq.ijlt.&c :entry points to output user program 
generated data to tbe screen or to the current output device if 

CSWL has been modified. Also, entry points sre described to 
trsnsmic standard types of output (blanks, bell code, carriage 

return) to the output device CgeneCall? screen). 

TEXT OIjTPUT HITliOin THK SCROLL WINDOW 

describes the entry points used for placing characters on the 
screen outside of the Scroll Window, and for reading- the iwyboard 
when echo to the Scroll Window is to be performed. 

SECONDARY DISPLAY AREAS 

describes various ways of i^^-^g. the Secondary Text area, even fo,r 
llniited Scroll WiTidw fuastttais; such as allowing keyboard input 
epfio to gQ K:,f> .tlye -S^taitJd.ttty asea^. 

Any entry p^illl lAiJiCft "fi'ts into we're than -sBe siate^rj wiJl be- -fetu-Md 
in each appropriate address table. 



OUTPUT WITHIN THE SOROLt WINDOW 

Scroll Window operation is compatible with printer or typewriter 
output In that new characters are displayed to the right of previous 
output, and new lines are displayed below previous lines. It is this 
piode of operation which Is described in this section, lliat is, this 
section, describes "printinj;" information by means of the CSWL vector 
to the screen or to a printer type device. The section on General Text 
to the Screen describes use of the screen, bypassing the GSWL vector 
and niaklriR direct use of the Scroll Window output routines. 

The normal method provided in, the Apple II for displaying output 
information is by "calli^n'g."' cSW i&Xii tbe character in the A-r#g f-Sr 
each dtsplayable cha-faetet' or fotiHat, control character ^aijeh aa -a- 
.(^f^ig^ r^wraS- At Offllr ^ ■■^^MP ^Itfai'^iet; &^ ^'s, fefe 'tfett«St 
to the routine Which will place the character on the selected medium 
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or accomplish the indicated control function. When the systeni 
Initialised, this vector is set to point to COUTl which supports 
Scroll Window output to the screeti. If the user sets a different 
outTTOt .device (by PR#n in iWS^C or ctrl-p In MoiiJ-tor mode)^ then thp 
:%mt vKfitro*- will te: get to paa*. 'the, wI'^mi: ^10^09 xp the: 5*l-ectsed 
•periplaefal contfoller card instead .of ta tfe-e- ^*«sav ti^esding on 
which peripheral controller card, and *,ieh sstltrola ar-e actlvBj, Che 
program an that card may place the character on the output d^ytce, and 
thtiri, to COUTl to write it also to the Scroll Window. 

■ftte-normai -mode ot cext OutTaifi to the Bcfeen is- In '*sefoll" mode. In 
.tB*S Bwa*, 'ae^W 'iiifio^idtlsjii' -is wri^tten t&, hUttam line of the 
screen, and the contents of the screen are moved up, up, and away as 
required to allow entry of new 1 nf orraat Ion below the old. This mode of 
output is used In APPLESOFT or BASIC "PRINT" statements. This is the 
raode of output (ised hy any MoniCor corninand which displays data to tlie 
screen. 

As new characters are written to the screen, they are placed at the 
position of the i-ursor. Thi? cursor position Is a location on the 
screen {and in screen refresh memory) specified by the contents of 
certain fields In page zero. Also, the Scroll Window is a portion [or 
all) of the screen as defined by the contents of certain fields in 
page icero. There is no special display hardware Involved with the 
scrolling function. Routines In the Monitor move data In the screen 
refresh TnemoVy aa required to support tlie scrolling (imetlon. 

The. fi'^lfla fa ^.p^ dea<;Ei%I.B^: tl^ fgSoU lii4lTi^ce the left 

column and width, -and the tn^ feottOm .llttea:, ..AeAstiheA TieLte- 

The cursor position Is defined In various fields, and unless a user 
program Interferes they will be compatible. 

llle screen line nutttier of cursor position Is contained la the field 
CT. CV indicates the line number of the cursor rel|M-ife t& tte 
line of the screen, not the Scroll Window. (Note that this Is 
different from ClI, descrihed below.) The screen refresh memory 
location whicb corresponds to this line number is maintained in the 
two byte field (BASL.H). Note, however, that If the left edge of the 
Scroll Window Is not the leftmost character of the screen, BASL,H will 
have been adjusted to point to the leftmost character position on that 
line within the Scroll Window. Thus, a program may Interrogate CV to 
determine the line number of the cursor, but the program cannot just 
POKE a different line number into CV to move the cursor as BASL,H must 
be updated as well. 

^tift horizontal position of the cursor is maintained In CH. The value In 
CH is relative to t;he left edge of the Scroll Window, not necessarily 
to the screen. JJJjSil a character Is being "written" or "printed" to the 
screen., Clia .TlOWiti&a ?ihicli- Rlaces the .iSiaraCter m screen refresh riemory 
u^es tills Y~«ag to^I^itttitai poalSit^, 1% ;tlie assumption that It has 

b«en loadeiS fr&ni ,C!Hi In the address talAe* <Sacti description indicates 
whether .the ^#utine tseing called uses Cfl or ttie T-r^. 
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For machine language programs. Scroll Window output is most easily 
xcomplished by a JSP to COUT at SFDED (-531) with the byte in the A- 
ri'i^. From BASIC the same thing Is accomplished by PRINTlng a variable 
In which the byte has been stored. In BASIC, of course, a shole string 
can be written with a single command. 

As the- dharaeeerp 'BFe passed through COUTl, they are modified-, 
ft:e*^^,B3fty , be tttltten in white hlacl<;. black OB- i*lte, flC 
El-asiiii^, ''m acGoMsTiGe, vd.th, the contents af- the fi^xA cal'le.d lS^FI^!» 
Thfg, ti^S-H B»fi' fS^S^)- at, and Is Immedlatelj 

effectl've on all £titiii;« ^ha-eacters printed by the program until It is 
again Tiodlfled, ISiiS :£tinctl<Sn ^Bly applies to program print output. 
During keyboard" etitry-, tIWPK5 Is temporarily changed to as each 
Input character is echoed through COUT. 

The two byte field BAS2L,H Is described below although it is rather 
useless for user program reference. It is a work area used only 
during a scroll operation- 

PAGE ZERO FIELDS 

Dec Hex Poxitlne ^sgel^ptl^ 

32 32U WNDLFT Left column of the Scroll Window: 

Range is ? to 39 CS27). 

This field is used only in VTABZ. The contents. 
When changed by user program, become effective OH 
the next scroll operation,, cleat to end of pagfe 
operattisn, or carriage return Output. CH eootal&s 
cUTEoc horlaontal position relative to CWNDLFT). 

After laiaogfns -Che contenta of wndlft, either iJAEl. 
VTAb or outjut a carriage xeturn to make It take 
effect. 

33 $21 WHDWDTH mSfch fflf the SeColl Window: 

i^: 1 'tS 4Si-(WNDLFT). 
When a character is written through COUT to the 
screen It is placed at CBASL),(CH), after which CH 
Is Incremented. At that time (CH) is compared with 
(WNDWDTh) to determine whether the cursor has 
exceeded the? right margin of the Scroll Window. 

34 $22 WNDTOP Top line of the Scroll Window: 

Range Is to 22 ($16) for full text screen. 
Eange Is 29 to 22 (Sl'i to $16) for mixed graphics 
and text. This field Is used during a scroll 
operation to Indicate hhere the operation should 
.Start. 



KEYBOARD INPUT AND SCREEN OUTPUT 31 



pea Hmc R<wtto^ Description 



35 S23 WHBBIK Bottoin line of Scroll Window +1: 
Range Is Cm'DTOP)+I to 24 (S18). 

WNDBTM indicates Cho first linf nvimber below the 
window. Contents of WKDBTM are tested only on 
output of a carriage return (S8D) or line feori 
(S8A). It Is used by Clear to End of Page and by 
Scroll Toutrines. 



3S $24 CH Displacement from WUDLF'T wfie-r.e next- cliaraeter to 

the screen will bp placfi^,! 
Range la 0' (VHWEmJ-U- 

After the •acf.m§ piKp^t f^^t^Mn. STO^^ J'^W^S ^■ 

camp&'^kS. to "B^JSTK. if is:- -(ujfe "ia^' i^en a 

Note that CH is used for echoing i^yfeaard input to 
the screen by the Monitor routines- S^TLH etc., 
liecauae GOUT is used. 

37 S25 CV Vertical screen position (line number) for neXt 

character to be written to the screen: 
Range is to 23 ($17). 

The content of CV is relative to Che top of the 
screen, not to the top of the Scroll Window. It 
may be set by loading the desired line number into 
A-reg and calling TA6V. It may he set by POKEing 
the line number into CV and then calling VTAB. 
Actual storage of a character into the screen area 
includes use of BASL,H for line number, ni^t CV. 
The calls above to VTAB or TABV are to set BASL.H' 
tx<m Cy for imjoediate fut\i(;e r.ef^renc-e. 

If Is at- or h^lm Wtcp^, it ■im.XX vsm&irt m 
current line as cara^iage i&iut^ gpo ify ^ile the 
eoSljsnts of tlie Scr'all Hlndow will be sci^lled fgi 



40 $23 B&St T5ils"two byte field ts thf mewoi-y afidfe'Sg foi- the 

41 $29 BASH left end character position of the current text 

line, within the Scroll Ulndow. The contents are a 
function oE CV and UTOLFT. 



This field is set by the BASCALC routine to point 
to the nieraory address for the left end of the line 
specified in the A-reg . This call to BASCALC is 
usually aceoiiiplished by the VTAB roQtine, which 

then adds (UtJDLFT) to liARh,H to paint to the left 
end of the line within the window. 
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Dec Uex Routine DesscriptiQn 



'•2 S2A BAS2L This two hyte field Is used as a work area only 
li'.i S21i BAS2il during a scroll operation. It is Che destination 

line pointer used as uach line- is Kiov^ to tile 

position above current. 



5|if £32 IHVFLG This byte is a mask used by COUTI to cause 

Characters written to the screen area to display 
white on black (INVFLC=5FF) or hiack on white 
(IMUFLC=S3F) or tlasliin^; (inVFLC = S7F ) . This field 
is set Co $FF when a RESET occurs by the routine 
at SETNOSS.. 'WSi- toflti^^ 'ffaHhd SETIHV can W 
called to set tev&rse video. The Jlonitor does not 
set flash-fiKg. 

flasb-: ttle upper Z hits of tKe character nttist be 
01 for flashing to occur. 

53 535 YSAVl Tliis byte Is a save area for the Y-reg across a 

call to the screen output routines. V-re)» Is saved 
and restored in the COUTI routine. 



U $31") CSWL This two byte field contains Che address of the 

55 $37 CSTIW routine which is to receive and dispose of output 

characters. When the RFfiET key is pressed, this 
field is initialized to point to COUTI to send 

output characters to the screen. Entering a 
^^on^ tor Command nl*c (n = port numbe t , Pc =cont rol— P) 
will cause the Monitor to set CSWL, II to Cn?i0. The 
Routine at tliat location will then receive' (in the 
A-reg) «ach hjte "written" through COUT, which is 
a MS (CWUJ- ' 

If Ifettl't^i e^aaana "fe" Is ejcfecpted, CSWL.H 
Is set to point to CODTl instead of to C0i^. 



SCROLL WINDOW OUTPUT ROUTINES 



Function 

^ump via U^W\ 7, character print. ~ 
Write bye r in A-reg to screen at 

i-ursor (f;V),(CH) usinf; INVFLC and 

;in|)!iort i nc, CTirsnr move. 

Write hytt- in A-refi to screen at 
((;v),(aO with cursor move but 
not IHVFLG. 



HCK -l-nec -Dec Monitor Registers 

Addr Addr Addr Label Destroyed 

"FDED 55W^ ^^5TI mJT 

FUra 63008- -528 CdUTl none 

FDF6 6!i01i -522 COUTZ none 
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i'unctlon 



Heji -Wee -Dee SonJtiSt RegisterH 
KddT Addr Addr Label Deet roypil 



Print carriage reCiirn thru COUT. 






-fiZfc 


CROUT 


A 


friTit thru COUT "ERR" and bell code 


.FF2D 


65325 


-211 


PRF.RR 


A 


Print bell code ($H7) thru COUT, 


FF3A 




-19ft 


BELl , 


A 


Set BASL.H from CV (and IfflDLFT). 


FC22 




-993 


VTAB 


A 


Set BASL,H from (A) and IffliLFT 


FCKi 


6454Fi 


-988 


VTARZ 


A 


wichout regard to CV. 












Set RASL.H to left end of screen 


FBCl 


64449 


-1087 


BASCALC 


A 



Itn®' (net window line) in A^reR. 



CH 36 S24 WNDLKT 32 S2« 

CV 37 $25 WNDWDTH 33 $21 

38-39 $26-27 WNDTOP 3i S22 

BASL.a iMl. S28~25 WNDbTm 35 $23 

INVFLG 50' ^32 



S^REEW FQgMAT <50HTI^l BY RQUTINE 

IhiS. table iSeutifies the places In the !tonitor which control the 
dlstflay aode of opexatton and tbe Scroll Mliidow configuration. 



Func-t Iciii 



HeK +l)ec -Dec Monitor Regi Htt i s 
Addr Addr Addr Label ResCroyed 



-1229 A 

-1226 A 

-1223 SETTXT A 

-1220 A 



Clear HIRES graphics mode. 
Set display area primary. 
Set TEXT node. 

Load into A-rsR for WNDTOP, 
branch to SETWND below. 



& FB33 64307 

FB36 64310 

& Fri39 64313 

6 FB3C 6^1316 



Set Graphics mode. 

Set mixed graph 1 eg /fexl; itB5tl&. 

C^ll. CLJi-TOP tp .clftffT gcapblcs,. 



of WBTbP. Fall tu£a -t 



Set top litLfi qf v^t4^ f^K:DP)' 
from ^-reg-, ^ or JSi oX- usej' set. 
Pall tiast 'CoHtifet^,. 

toad i^S^, >rft"h S!' tor "SKDtiFl. 

Sl?gre.A~r'^ to KNDLFT. 

toad il-reg with 40 for WNDHBTH. 

Stort A-reg to ^DUDTH. 

Load A-reg with 24 for UNDETll. 

Store A-ceg to 'JKDTSTM. 

Load A-rcg with 2:i for VTAB. 

Store A-res Co CV. 

Jump to VTAB - set BASL,H RTS . 





FBi0 


64720 


-1216 


SETGR 


A,Y 


S: 


FB43 


6432 3 


-1213 




A,Y 


% 


PR 4 6 


64326 


-1210 




A.Y 


6 


FB49 


6432? 


-um 




A 




FB4B 


643.31 


-1 205 


HETWETO 


A 


■5- 


mm 




-1203 




A 


■'& 




'HM 






A 


S 




6<S'337 








& 


FB.53 


64339 


-1197 




k 




Fli55 


64341 


-11<)5 




A 


& 


FB57 


64343 


-1 193 




A 


(, 


FB59 


64345 


-1191 




A 


(, 


EB5& 


64347 


-1189 


TABV 


A 



Funcclon K;k +Bec Monitor Registers 

fiaSr Affdr- AffajT label Destroyed 

Load V-reg w^th for mt'LC. ?E54 -3H(J aETWOM V 

Fall into SETIFLG. 
Liiad Y-reg with $3F for IMFFLG. FE80 65152 -384 STOMV X 

B-a to SETIFLG. 

Store Y-reg IHl INVFLG 3Tid RTS, FE86 65158 -3/8 SETIFLG none 

3FF tftltre-Oti black (frcm SETNORll) 
fiF Maeic oii i-fliite, {from SETINV) 

flaSteftg fcha«aijfe«i!a from user call with upj^.E' 2 Irits oE 

Set em,,)l to point Cd. CQIjri. FE93 65171 -ISS -^TVIB' A,x.Y 



CH 


36 


S24 


WNDLFT 


32 


■S20 


fV 


37 


52-, 


wndwhtii 


33 


S21 


TNVPl.C 




S32 


WNDTOP 


34 


S22 


liASL.d 


43-41 


528-29 


WNBBTM 


35 


$23 


CSWL,II 


54-^5 


$36-37 









SCREEN FORMAT CONTROL 

BY POKE/STORE 

In inaiiy cases, the routine in Che Itonitor described on the previous 
page exists because the Monitor Itscslf uses the function described. 
O£C0n, calling the Itonitor for a specific control function ig doing it 
the' hard tpy^ This table indicates other ways of accompl i siting the 
same rbsulCB.,,. 



KuncL Ion 



Method 



SlL GRAPHICS diapJay mode. 
S.'.t TKXT display raodc. 
SeL CRAPRICS nofic to full screen. 
Set MIXtlD GRAPHICS and TEXT fflod«. 
Set display to Primary Area. 
Set display to Secondary Area. 
Clear HIRBS/Set l.ORF.S for graphics. 
Set HrK-S's 'Srajililes itofe- 
S.et XRP lin^ Of Scroll 



Srt" left -^m ^ ■Se'SpU l^TjeloM. 

Sec widtli of Scrqll Winflow. 

Set hrictom line of gcroll WlqdoWi 

Set Hornial (white on blacfe,) text. 
Set Flashi iiR text . 

Set Inverse (black on wbite) text. 



POKE -16304,0 or STA C050 

POKE -16303,(1 or STA C051 

POKE -16302,0 or STA C052 

POKE -163(Jl,f) or STA C053 

POKE -1636(0, a or STA C054 

POKE -16299,0 or STA C055 

POKE -16298,0 oar $TA 1^56 

^t6lS3.,^ or Sf A, C057 

Sottsm" mam W giaater ti^-ri top.. 
POKE 32,e(jJu^n-^^iivbBf <|-*9) 
Left edg^ + vidth' htSt to i^Kceed 40. 
POKE 33,number-of-coluiiins (1-40), 
Left edRe + width nut to exceed 40, 

POKF T5, line-number (1-2^0 
Botcon must be Rte.iter thiin top. 
fOKK 50,255 or store SFF in $32 
POKE 50,127 or store S7F in S32 
POKE 50,63 or store $3F in $32 
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If the above means aro used to chnrif^e the Scroll Window conf Ip.ur.itlon , 
the user program should also Cake steps to Insure that the cursor lian 
a valid position within tlie window (GV, Ca, BASL.H). GALL -936 will 
place the cursor in the Window. 

SC0')0 and SC051 control Text mode vs. all or some graphics. The other 
items ref^ardinfi HIRES or LORES or full or part Hcreen graphics may be 
estalilished first, but will not be apparent until SCB53 is tickled. 
Likewise, $5051 will bring bacTf T-SKt Mode re^ardlesa of ttie echer 
settings. 

SCROLL WINDOW DATA MAWIPULATIQHS 

This tafels 4m&rifim cfMsee t^^G- dt gcroll window SAt-a 'fflftiiij^fatloTi 
etitcy points. The first ;tfonli:ar label b;sci,, -tJve Eaj^fiB S/ef 
Processor, "heeatts;e It cffHssfaxB control to .a nmafeer t£ the ottei? eatry 
points depeniits^, ij^fV "J^ ^^^'^^g fiO«C^:n.rs, ^xd. ?a-pry teigg s^C. ifin® 
entry point sf tlife .AQpoSStti^ AMttStr % "inel^ea feeiiafcSt- li tbaiidl-eis 
una requirement t>f - thst Carry be set. 

The second pact of the table is a list of entry points supporting 
clearing or setting parts of the screen to a particular value. 

fEhe third part of the table describes pointK causing conditional or 
uncondi Clonal scrolllag of the vind^Jw. 



ADDRESS TABLE 

Function Hex +Dec -Dec ilonitor Registers 

Addr Addr Addr Label -Destroyed 



Call scree^i d^ta raanipulatlon. FC2C 64556 -98^1 ESCl A,Y 
If Cairrj!, "fg.- set and A-rag = 

p mm. 'nptm 
A gctto aiMuge 

D g'cto W 

Othfer ftTf!" to caller. 
The RTS at the end of each of 
these functions returns control 
to the caller ©f ESCl. 
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Function 



Hen +l3eG- -Dec Konltoe "R^lfitecs 
Addr Addr Addr .L4bel %e.t*ft'yed 



Clc.-ir from line (CV) col (CIT) Co 


FC42 










end 111" Scroll Window. 












Clf.-n- Trom line (CV) col (Y) to 


FC44 










I'lid of Scroll Window. 












CU^tir from line (A) col (V) to 


FC46 


64582 


-954 


CLEOTl 


A.Y 


i-Tid rif i'.oroll Window. 












(:i(.-.ir Sci-!i]] W-indow to blanks. 


FC58 


6460(J 


-936 


HOME 


A.Y 



svt cursoT- to top left corner 
t hi.' wi nd ow . 
Set ai=W, CV=(A), cltar to EOF 

(end of pa^e = end of window). 
Clear window from line (A) to 

blank, set cursor to left end of 

I ine (CV). 
i:iiMr line from cut-aor 

( (HA,';i,).(CH)). 
Clear line from twa^t (?ASL),Y. 
Het cheiapter in A— fieg fEOm- 

ciii-BOr (m,S'L'),J t<¥, Re!4-Jife. 
CI-e»F llnp (BA^Jj then set 

harl.h from cy afi'* vm}.vi.: 

Clear line it^m eui-fi&r- CSra-),"!:, 
,tb:en set ?ii3I.,l! from CV 6 WNDLFT. 
'CM t-eraalna unchanged, 

y.rro to A-res for CH. & 

Si ore A-reg to GH. & 
I nr ronen t , 
Cdniiinro CV to WNnBTTl. 

Set BASL.H; if (CV) < (WNDRTM), 

do (Scroll if reiiijirsd-t 

'ii-roM r lie window, line* (CV) 

thru (WMDBTH). 
M(-ni|] the windovj, lines 

(A) through (WNDBTII). 



ftBtBgeart ttonitpr Sifeteitfeel ^'exvlce 

.Set Carry flag afSA Alip -m tSM 
ta. hanaie ■M'mp^' fce^ ftmec'lons 
A. B, % 



FC5A. 64602 
FC5C &4604 



-934 

-932 



CH 


36 


S24 


WfJDLpt 


32- 


$20 


CV 


37 


$25 


WDWDEK 






1 NVFl.C 










522 


tlASL.H 


4(3-41 






33 


$23 



A.Y 
A.Y 



FC9C 


64668 


-R68 


CLREOL 


A,V 


FC9E 


6467^ 


-866 


CLEOLZ 


A.Y 


f'CA0 


64672 


-864 


CLEm.2 


A,Y 




64661 


-875 


SQHL3 


A,Y 


FES? 




-873 




A,Y 


FC62 


6461(i 


-926 


CR- 




FC64 


64612 


-924 






FC66 




-?2Z 


IT 


&,n 


roes 


64616 


-920 








64624 


-912 


'SCROLL 


A.Y- 




64626 


-910: 




A.Y 


FB97 


64407 


-112^1 


ESCOLD 


A,y 
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CURSOR POSITION CONTROL 



In general, the Cursor la at, tte ■^eftlDn indicated by the coutenta of 
CV (line number relative t<3 top -of '^.r,ed6> and CH (coluiin nufnber 
relative to to the left margin tke- &EvalX Window). The memori' 
location Df the cursoi Is- ete stm- of tTfe. eaiitenjrB. o^-SS^>W .Cwjijcli 
contains tbe address Bf the lelfemost ehHtaeter of t^e Itee within tlte- 
Scroll Window) and the contents of CH. Normally, thpn, EASL,il contains 
an address computed from the contents of CV and WNDLFT. However, If 
either CV or WNDLFT is changed jflthout recomputing BASL.H then the 
different, routines of the Monitor may come up with unpredictable (or 
aC least undeslrM) results. 

In the following table, the liescrlpLinn includes indication of which 
of the cursor address fieltJs is being used for wb.-it. Note, for 
eKample, that at SFC9!) the line indicated by RA3L,H ts cleared, and 
then BASL,H is recomputed from CV, 1#1DLFT for future re fi^rcnces . 

The ESCl and VinOUT routines are included in the table because they 

can be made to use tKti 'O^^- fentry points by passine tbem the 

appropriate A-reg contents on entry. VIDOUT is the routine which 
haniiles CR, backspace, and line icc-i when such characters are sent 
through COIJTI (generally thru COUT). F.SCl is the routine called to, 
accoinpliah the desired function when the keyboard routines are 
opecating in ESCAPE key mode. Thus, it has four way cursor tnovement, 
capahllity, as well as the capaMlIty of clearing the Scroll Window 
from cursor preg.ejit pp^eifiti t^: end of cyTrpnt Xi^^- 9'^ end -&f Ehe 
Scroll WiniJoMj -gt: t>t- EleaEing tlie entire Scf-oll Si'RdflW' mi vVm-frt^ the 
..car^* at ih^ tft^ '2-0ft eWt^ee" :<^- It." ihg itj^tlon ^rl^E*^. '^fii^eHd'S 
atfon the epjitents inS ths ^-^eg at entarys mi4 ^Ire- *-Se«" conMtloTV of 
the Carry utoceasor status Vit* 

■KoC»4! ©oiBt BSSffJiB <S(i im-4^art: Monitor is Included in the t^ble 

due to its relationship to ESCl . 

The next group of points contains those which clear data on the screen 
as well as move the curaor-, 

The third Rroup is entry points supporting nrovetEent of the cursor 
relative to its current position. 

The Fourth group supports positioning the cursor at ,1 desired location 
without reference to its current position. To do this, the proigram 

should set CV and CH and then call VTAB to set MSL,IT. 
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ADDRESS TABLE 



Kun.ctiott- 



■fiex +Eec -a^r. Koni tot Registers 
■M%<e' MdT AAAr Label Destroyed 



-Call ficreen/curso-r n^ipnlatl'oti. 
If Carry Is set and' A-reg - 

P ROtrt HOMK 

A fioto ADVANCE 

li goto BS 

C jjoto LF 

II KOto UP 

E goto CLREOL 

I'' goto CLREOP 

other RTS to caJler. 

Tlic RTS at the ^nd of each of 
r liei;o functions returns control 
to Uic caller of ESCl. 
Set Ciirry flas and JtlP to ESCl 
III b.indle Escape key fnnctlu^js 
A, B, C, D, E, S. 

Place character fft (Sefeen memory 

iir proceas contrSl ■cMi-:^cZ^. 

It (J.) > S9F or < 580 gpto ETOABV. 

Tf i>A) " goto CR. 

IS {a.) = ^BA goto 

If (so B S38 goto BS. 

If (A) = S87 sound "boll". 

If (A) = other ii;nore It; RTS 



FC2C 6455« -980 ESCl 



FB97 64407 



-1129 ESCOLD A.,y 
Autostart anVf 



FBFn 64509 -1,027 VIBO&T A,Y 



I'lciir Scroll iJlndow, set cursor to 
I o|i left corner of the window. 

ai=(^, CV = {A), clear to EOP 
{I'lid nf page = end of window). 

y.\i-:n window from line (A) to 
I'l iiil^, set cut-aor to left end of 

1 Inc (CV). 
Cli>;ii I (ne (nAf!!,), then set 

ilASl.JI from CV and WKDLFT. 
i:iiMr line from cursor (BASL),Y, 

tUci\ set liASL.H frcm CV fi IfflDLFT. 



FC5a 


64600 


-936 


HOME 


A,Y 


FC5A 


64602 


-934 




A,r 


FC5C 


64604 


-932 




A,Y 


Fl;95 


646&1 


-875 








646*3 


-873 




A.t 



Ktiiru A-tisR t®. etitem -at JaASLj,-'! % mvi 



CBj^fifln* ItfO. with 
%azo cu tf CH n^t leaa. 

Sine return'' <R'tS>. 
Move nirnfir left one column, to 
r Iwht i-ikI (jf previous line If 

requlri>d and (CV) < (l.'NDTOP ) . 



S' rBF6 



64498 
6i50a 



-1840 
-11338 
-1036 
-1034 



FC1(J 645ZS -1008 BS 
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Function 



Hex +l>ec -Dp.h Monitor RcglstecB 
Addr Addr Addr Label Destroyed 



Hove cursor up one line 


FCIA 


6i538 


-998 


UP 


A 


If' <CV) < (WNDTOP). 












Zero to -A-reg for CH,. & 


FC&2 


64610 


-926 


CR 


A,7Y 


Store A-reg to GH. A 










A,7Y 


In^rsanect £3/.. fi 


TC66' 


6i6l4 




VF 


A,7Y 


rc59 


'64616 


-920 




A,?Y 


tf tfa.^ "I6s9.djac:e^!nient ^ and 












do BCxofl. 












If CV less goto VTABZ to .set 












BASL,1[ and return. 












Place ctirso f ^t line (A) col (CH) 


FB5R 


64347 


-1189 


TABV 


A 


(store A to CV and set SASL,H 












by J!1P to VTAR) . 












Set BAKI,,H from CV and HNDLFT 


Fe22 




-99,0 


VTAB 


A 


hu rail BASCAT.C anri arlH IJfJDI.FT. 












Set BASI.,n from A-reg and WNDLFT 


FC2A 


64548 




VTAS2 


A 


by call BASCAJX and add UNDLFT. 












Set BASL.Il to .■neiiiory addrtss for 


rsci 


64449 


-1087 


BASCALC 


A 


left character of line in A-reg 
























JuMp vl3 GSML, character print. 


FDED 


65005 


-531 


GOUT 


?A 


ChaXactst ptint screen output 


FDF0 


65008 


-528 


COUTl 


?A 


rowtliie eatty?." 'SoiBtal for CSWL. 












Sfi-Rt cll^iSftftS^ to B£:leen with 












ajiurfijiElat*! AcMons ea controls 




































inverse '^4^^ wa'^. 












AUTOSTART MONITOR ONLY 













Print character Co screen via 


FDF6 


65014 


-522 


COUTZ 


none 


VIDWAIT (pause If oper.atoc request) 










and VIDOUT with save ana restore 












of A reg and Y reg. 












OLD HONITOR ONLY 












Print character to screen, via 


FDF6 


G.5014 


-522 


COUTZ 


none 



VinOITT with save and 

of A reg and Y Te.g, 



j-eatore 



fiASt.H 



36 


S24 


WNDLFT 


32 


$20 


37 


$25 


WNPWDTH 


33 


$21 


50 


$32 


WRDTOE 


34 


$22 


40-41 


$28-29 


WMDBTO 


3,5 


523 



40 MONITORS PEELED 



GENERAL TEXT TO THE SCREEN 



Tin" preferred method of sending text to Che screen Is by loading Che 
riiar;icter desired Into Che A-reg and call!nj> ,';0UT to handle it from 
llifre. The reason thfs is pre?ferred Is that if you want to send the 
imi|>nt to some device other than the screen, you can change CSWL,1I 
< >i point at the program supporting such other device. There are 
Mine::, however, when you'll want to write Co the screen regardless of 
t 111' si'tLing of CSWL,H. C0L1T1 Is the entry point for screen-only 
oiiliiiit, where reverse video display or flashing charaoters are set 
using ItlVFLG. Eatry at thl^ po.lnC for the Autostart Monitor also 
flUowfl you tQ B&o^- aWcpxh, tiaii^ t^ie «stttiroI-S;. k^f . 

eauT?. may jje wsm f^r'^tpti^ ehe' J|«r.eeft ■ijttftout- MOffityitig the 

clinract^E 1^ Ji^ij^: INWLS* ^pfe8» -.is, calling COUTZ" with a Character in. 
Lhe A-r^ i^-ll [d^cSfe that dHa^kjster on the screen aS i's, Idthout using 
INVFLG to display the character In Inverse video or flashing niode. In 
the Autostart Monitor, entry at COUTZ is still early enough to handle 
control-S entry, stopping the system If the character being written is 
a Carriage Return while the keyboard buffer contains a control-S. 

VIBOUT Is the routine which Interprets the character and places it on 
llic screen If it is not a control character. If the VIDOUT rouClne is 
to ha called directly (to bypass control-S handling in the Autostart 
Monitor, for example), then the calling program must save the A-reg 
nni] Y-reg before and restore the A-reg and Y-reg after, because they 
are both destroyed in the VIDOUI CoutCne. 

Output to the screen may be written via these alternate entry points. 

However, note Chat the Monitor will still use i;OUT for the keyboard 
Input echo function, temporarily setting to- SFF for wlilEe 

hLick for each character echoed. 

following are addresses of the above mentioned locations, and a few 
other eritTry pdints rfiitfi -SiH E'Ke "gpeeiete^d Sfeafcacfeei^si) ^fia 

couT) without the calling, program' ha-vlag to load them Into the A-reg 
before the call . 



ADDRESS TABLE 

Function Jlex +Dec -Dec Monitor Registers 

ftHEfe Addr Addr Label Destroyed 

Print a byce Co specified ouCput TDJlD 65005 -531 GOUT none ' 

device by JMP (CSWL), normally 
COttt-I lor Bcreen. 

ChiirHdter pr,l«t to asreeH ^tri^t FDF0 65008 -528 COUTl none 
routine entty - fl'otraai .^r 'd^t. 

Print charaCt^e m acfeen with 
appp^opria.E* ae-tians- on controls 
and control charaeCfttEi. 
If (A)'<$A« goto eotm^i byp-ms 
Inverse video mask. 
AMD fA) with IWPLG. & FDF4 65012 -5?4 ?A 
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PunctioTi 



Hex 
Addr 



+Dec -Dpc Monitor Ref. i k r i" rn 
Addr Addr Label Destroyed 



Prin!: a "byce to 'the screen. 

See AUTOSTART and f)LT) differences 

toward end of this Ciible. 
Process char, in A-res! to screen. 

If control cliarficter, do control. 

If display character, <!tore In 
screen refresh nemo rv . 
Store A-rep to screen at 

(BASL.H) ,(C1I), then Increnent 

CH and f^oto CE. i¥ 'Window exceeded. 
Store A-res to screen at (BASL,n),Y 

then Inc CH arii pfita CR if wiadow 

Ine.^JSgHC, CH snA Bote CR if window 

■Test CH. Got-Q 1^ if (M smjDTO. 

If A=Sftn,^ S8A, SfiB, ttr 
SBD carrlap.e return ^tntQ (M 
line feed gSis %f~ 

gfe hack space. ^REf M- 

S87 bell s»'Uiiil"'n^l*' 

Set INVFLC to S3'F = Inverse rtrfefi.. 

■get IWPJ-G to. $TF' = normal video. 

S,et a wis ?roPi,^-reg. 



FEFB 64505 -1027 VIDOUT A,Y 

FBFiS M4?6 -1,040 STOADV A,Y 

FBF2 64/(58 -1038 A 

FBF4 64590 -1036 At^JANCF;. A 
MSlfi 



FC(1'4 



-1034 
-1020 



AUTOSTAFT MW-ITTOR Om.Y 
Print ■ahsrjaep^r tp, .ficme^.P vi^ 
VIIWATT vsCoTi if opeTafeor reijiaefltS' 
and VIDOUT with save arid fes-toTe 
of A and Y regs. 
Teat for operator pan^e rfiniicst. 
If CA) = SBD (carriage return), ;ind 
if keyboard register is full, and 
If keyboard rep, contains cntl-K, 
then Ta! ] i nto KFnUMT, 
E 1 f;f, i'.oto VIDOIIT. 
l^aiLse sv steTn pe r ope ra to r requeSC ■ 
l^oop until new key iirt's^aii^d. 
If next key pressor' is cntl-C 
then !;oto VTIIOIT, leaving cntl-C 
in keyhoarrl re^^ister. 
Flse, clpar kevhoard strobe and 
EOto vinoiiT. 



A 
A 



FF80 65152 -384 SFTIt!V H 
FF,84 65156 -3^0 SF.TEICBM ¥ 
rv.m 6515B -378 S"^ifif3:l^:t 'm^ie 



FBFh 4 -522 mmz none" 



FB7R &437fi' -116!^ VITOAlT Y 



fm& 64392- -1 1 44 KBHWAIT y 



01. 1) nOMITOR OMLY 

J'rint chjiracte-r to Kcreen vis 

Vliiaux wiCh 'save and restflj-^ of 

A-res and Y— reg. 



FDF6 65014 -522 COUTZ 



ttone 



inVFLC 
BASL,lr 



3f. S24 

17 $2 5 

50 S3 2 

i0-4l ,428^29 



umu.FT 

HWDWTITH 
WHMTM 



32 
33 
34 
35 



S20 
$21 
S22 
S23 
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CONTROL CHARACTERS 



tote: 

Thr following control eharactera have, spmci'al meanings for s'ct&en 
d I Bill ay . 

SRil Carriage Return 

In the M.t,«s-t.*iiFt Tiimitor. Elve ;^IB^ ^Oiffl^ie calls (JSE) VIWftiT, 
which liandles the eiSrtEfdI-S filftOtiOQ BsSfo-re .iuraping to "VIDOIIT. 
The COIlTz routine In the OlA Monitor oalla VIDODT. 

Uhfn Che VIDWAIT routine de.terminri; Lhac tlio character lielng 
"written" 1h a Carriage Return, it then tests the keyboard input 
hiiffer for a control-S. If so, it clears Che keyboard hardware for 
.mother entry artd loops until another key is preHsed. If this 
I'ntrv if; other than a control— c, the keyboard Ktrobe is cleared. 
Oihcrwise the keyboard is left filled with the control-C for the 
calling program to detect and handle. Then. VlOffAlT JMP's to 
VIDOUT, 

.$HA Line Feed 

Tlie cursor Is moved down one line unless this would put it on a 
line below the Scroll Hindow. In that case, the contents at the 
Scroll Window are moved Up one line, and the .curs,or stays on. the 
current screen liixe. 

The VIMBT t'E^tim miiv«s ¥.he ^QCsot to th^ l^^f ^ .^ce 
decreraentiTis feH. If Ch' ^cih's negative l"t Is; J?0 <WSlSJEfFH-)-l dXiA 
CV £.s "d^e^'eiVtesi.. If decrementing: C¥^ Utowld take It above fWNDTOP) 
6V'ls not deefemented Negative sccsli la- tio:E supported. 

JH.' Konnd Che Bel 1 

The speaker Is pulsed 1000 titties per second for one tenth oE a 
Hecond ■ 

Any other character in the range S^I0 thru S9F is dropped. Xt does 
not cause cursor motion or tTeniory oodif Icatlon. 

OUTPUT WITHOUT THE SCROLL WINDOW 

II' Jill or p.irt of the screen is to be used In a direct addressing 
iiiiiMiier, It is necessary to avoid certain Iforiitor services. In general, 
llic Hcr^ill Window servlEea provided by the Honitor are: 

1. Kfroll all text in Che windcmf i^ one line if a carriage return 
or line feed Cakes the cur'aor doim through the, fcottort line of 
Lho window* 

2. Autorantlcfllly aesuae ca-xrlage return if wIn4ow wldcli is 
exceeded - 
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3. Place- the cursor at th(> left edge iif the Scroll Window Instead 
of at the left edge of the screen on a carrliige return • 

Support screen clear functions: 

A. Clear the window, place cursor at top left cornur. 

B. Clear the window from current cursor position, 
e. Clear line to- che rigtit of ,eui?or ppsltJoTv. 

When using all or part of the screen a random access display, these 
automatie services need be avoided. 

If the full screen is to be used as a random access display, without a 
portion being used as a working Scroll ^£ija^, the problem is not Coo 
difficult. Consider leaving the whole screen defined as the Scroll 
Window'.- 

■S-irbll Miidew-. .Avoia, ttiVs ^ not feaVIiig ttie-, piiogtai?^ SiSBVt, 
IF or excessive data on the boCtora line of the screeiii and by 
keeping the cursor away from the bottom line of tSfe scraeti 
during keyboard input operations-. 

2. The full screen Is defined as the Scroll Window by the Moptttir 
when the RESET key is pressed. A user program can restore the 
window parameters tD this configuration If they have been 
altered by calling "Set Normal Scroll Window" at SFtl3C or 64316 
or -1220. 

3. Position the cursor where desired before printing a serine of 
characters: POKE the line number into CV and call VTAB for the 
line and then POKE the character number Into CH. 

h. Output the string of characters by the saiiie means as if operating 
with scroll services, being ear.^ul not to unintentionally 
exceed window width or ou't;$.i;iC eaKt-lage returns. Depending on 
your screen design, howevec, you laay Inte-ntlonally do each of 
t-bese . 

ifot!^- Eh'ftt fypogfaw (Jttt'^pttt Gf c^'riss^ rajfe&cfi 'J®? -tlsar E%e, line 
to, the Tight og .?i^c-ei<3^g cetjiips, "Tmt keyWaWl! tw^ti cacr-iege 
return does jeadi-lig tfe. .ke^'board Ib bettig dmfe the tferaiEot get- 

llne routines); 

If part of the Sn-T&sxi la to be allocated a&, an -operating Scroll Window 
while the remaiflder trf the screen is to be direictly addressed, then a 
different (Iqwex} level cE Monitor services nmst be called upon. 

One way to support .h d-ivlded so. reen is hy using the Scroll Wlnd<-jw f o i- 
data input with t!io tlonitor get-input-] ine services, and by using Che 
Scroll Window support for whatever output the program intends to put 
there. Then use parts of LORES graphics support for placing characters 
on the screen outside of tlie -Scroll Window, as descTlbed below. The 
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here is to leave support of cursor position (zero page fields GV, 
and liASLjII) up to the Monitor, and use other methods/fields for 
placing characters outsiide the Scroll Window. 

to place characters outside the Scroll Window, 

1. W-ith the line number in the A-reg, call GBASCALC to set GBASL.H 
to point to the laeraory address of the left character position, of 
the i.-jdifiiated: ^'eee.a -If-ne* 

2. With Y-rq^ -lnatGat'ii5|- boclzotiifcsl- piaSltton on- the line, store- tbe 
desired character- at"((SASL>,Y. 

fl.nte that this technique does not Interfere, wttfe t0SipS plotting If the 

Bt reen is being used in nixed mode, because fitiftl caWs' always set 
C.!\ASl,H as required: wlttitait r^gigrd to pasaibl-e prewious. contents. 

AimiliiT approach la available for the BASIC or APPLESOFT programmer^ 
A)',,i[n, the Scroll Window support can be used for some things, while 
I lie followinf; .Tpproach can be used to place characters on the screen 
i>iil!-;idc of th<! window. Tliat approach is to compute the screen memory 
liH'.itioii for each hyte to the screen, and poke the byte there. A 
V.I r t ion on that approach Is shown by the sample program. In the 
:iiMiii)lo, Che Monitor VTAB routine is used to assist in building a table 
III I'li'iiiory locations indicating the starting points of the screen 
lliii-s. This is an e.isier alternative than using the modulo arithmetic 
liinnuia described in the section "Pages Four thru Eleven". Note that 
.uliling 1024 to each value in Che table gives tlie nieniojy addr.esa -for 
lliiit Hue In the secondary display area. 



ADDRESS TABLE 



^"^lnctlon 



Heie 49e't ~l}ec Meni-^ot: RejAfetei^; 
Addr Addr Addr Label l}e^X^^Se^ 



^VUTST&E :Gf scroll ffliroow 

Compute memory address 'fer line fe ?8i7 63559 -1977 CBASCAiC A 
A-reg-, set GBASL,H. 



1 Nt; I Itt: fiCROLI, UIMDOU 

Wilic byl c lu A-reR to screen at 

i-;iyiirir (CV).(t:il) using INVFIG and 

Nui'iiorl i iii; cursor move- 
Wrlii' Ijvi. in A-rcR to screen at 

((:v),((:ll) wiLti I'Ticsor move but 

]iiH IMVKl.C. 
rl>.iir Scroll Window cc blanks, 

rH'j r r t op left corner , 
Set CV from A-reg, clear window to 

end iif window. 



FDF0 65008 -528 COUTl 



FOTS 65314 -522 pOZTPZ 



FC58 
FC5A 



f,4h(!0 
64602 



-936 
-934 



HOME 



?A 

none 

A,Y 
A,Y 



KEYSOA^ INPUT AND SCREEN OUTPUT 45- 



Place cursor at "Tine (A)~col (CH) 
setting CV and BASL,H frorti A-reg 

Set BASLjH from CV (and WbiDLFT). 

Set BASL.H from (A) and WNDLFT 
without regard to CV. 

Set BASL.H to left end of screen 
line (not window line) in A-res ■ 



Tl&K +Dec -Dec Monitor RepiriterH 

Addr Addr Addr Label Destroyed 

Tb5k 6^547 -1 189 TABV J. ^ 

FC22 64546 -990 VTAB A 

i:C24 64548 -9S8 VTAEZ A 

FECI 64449 -1087 BASQALC A 



CH 5* 125^ 

CV 37 32g^ 

GBASL.H 38H5g S2fi-2? 

BASL.H 4g-4l $28-29 

INVFLG 50 $32 



HNDTOP' 3S .$52 
■WSDBTM 35 $23 



APPLESOFT SAMPLE PROGRAM 



10 REM TEXT OITTPCT WITHOUT THE SCROLL WINDOW 

1 1 REM SAMPLE PROGRAJl 

12 REM READS FROM KEYROARD LINE, OlAE, STRING' 
14 REM AND PLACES THE STRlNfi THERE 

1003 REM PROCRATl ENTRY 

Din L%(23): REM LINE ADDR TABLE 

J 100 GOSU& 63.W.! KEM MAKE UP TABT,E 

1199 REM PRINT PART OF TABLE JUST FOR SUOVf 

12(30 TOR. X f -if to 2i: PRINT l,L%(I): NEk5 

1209 %m DELAY TO ALLOW L06k AT" U. 

1210 TOR I =■ 1. TO 50051: tffiXT 

PKI^l -Sm ?KI^ -eS- TO ALLOW CTL-^ SWP lijsii^. 

t^Z5 GAIi" - im^ 't^MAR. ScREEIi BETORfi' CftAWIfJfl MlOT^i. 

REM SET UP NEW WINDOW. 

1230 POKE 32,24: POKE 33,14: POKE 34,12: POKE 35.17 

12^5 feALL -936: RIM PUT CURSOR INTO WINDOW «lEA. 

INPUT LI,CL,SS$:REM READ A COMMAND LINE. 

1399 REM ALLOW A WAY OUT 

1400 IF SSS = "END" THEN 63900 
1500 SL = LE^H (SS?) 

1599 REM CHECK LEGALITY OF LINE, ETC. 
1510 IF LI > 23 TKKfJ 1R10 

151! IF CL > 39 THEN 1810 

1519 REM NOT PAST 40 THOUGH. 

1520 IF CL + SL > 39 THEN SL = 40 - CL 

1600 RM TOT PIARAGTERS ONE AT A TIME. 

1601 FOR I = 1 TO SL 

1700 CS = MIDfc CSSS,I,1):C% = ASC (CS) 

1720 POKE L%(LI) + CL + I - 1,C% + 128 

1740 NEXT I 

:H00 GOTO 1300: REM GO BACK FOR ANOTHER COMMAND. 
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lt(10 REM T.lrJE OR CH TOO BIG - ERROR. 

I 111 I CALL - 936: PRINT "NOT RQ BIG" 

1HI2 PRINT "LK ";Ll! PRINT "CH ";CL 

1J!;!0 GOTO 1800 

<^2<m mi 

M00« REM MAKE UP LINE ADDRESS TABLE 

6'1010 X% = PEEK (.-!?): REM REMESrlBER C? 

1020 FOR I = TO 23 

M0"10 POKE 37,1: REM SET CV 

'> cALt -990! mi G«i vrm- 19 .nih basl & bash 

6i,0n a|n,>-^ asfi * t ■0'i'»-+ i^J'Eli 

■6Mb^, fffiXT I 

BQI TABLE SETUP DME 
fil0'46 JtEM RESTORE CV AND RETURN 

610^0 P0KE '3?,^v Ggiil, - 990: REM WITH PROPER BASL 5 B^Sil 

I. '1900 CAI.L - 1^3: Mfrr RESi MSfMS trBLL VRjiW3&- 



SECONDARY DISPLAY AREAS 



Tile A|>i>lf II hardware allows usi? nf eichcr of two neitiory areas for 
dl:>|iL-iv i:o tlie scriicii. Ttio first, or prinary, in memory locations 
$M'i00-!'.07KF, T!ic secondary text (and low reHoliition graphics) display 
jiri'ii la 50800-S0BKF. This area is uomally overlaid by a user program 
(ir ilata, but in special circumstances a user inay desire to make use of 
iMh sficondary area as a ecxeen display area-. 

Tlif Monitor does not support the secondary display area as such. That 
la, tlie. routines In tlm lV:faiiat wtiich determine screen area memo-ry" 
ml(lt»sS'' 6toer Xine mmjifel? t0't character cglunm (CH) do so Qiily foar 

Ihi' pirlaary '^isjilay atea. tche'se" toutlnes perform cij'rrectly only fbr 
I Inns 0-£4. 

Follc(wine are descriptions of two ways of using the secondary display 



COPY PRIMARY TO SECONDARY 

There are tlFies wheii if^ 'S desiraftje to eliaage" tfte. di-aplay: veEji, 
a program mtglit ^rffapl*^ 4at& ■fefifitf -aeaffltttag, a 4lsk t-il&*. ijie 



hnrdaa-t^ --tiS -^S^sfla^ fT-m 'nie ^6^^ el^fl proceed to 

f>rni>rate "tho next screen data in the primary area wfttl« M.he operator 
I', looking at the Initial or previous display of reSttltS. A sample 
|ii()|;r,i:ii is provided later in this section showing how- trlie Monitor Move 
( out I Tic can be used to nove the contents of the primary .display area 
to the secondary display area. 
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SET BASL,H K>R SECONDARY DISPLAY PAGE 



When the floiiiCor places a character in the screen memory area, it does 
so using BASL,H as Che address of the memory location for the left end 
of the line, and (CH) as the displacement from the left end of the 
line. BASL,il t-.an he Initialized to the memory location of a selected 
screen line by setting the desired line number in CV and then CALLing 
TARV. On return from that CALL, adding 4 to BASH changes BASL.li to 
point to memory for the desired line In the secondary display area. 
This will last until the program writes a carriage return or writes 
cliaraGterB beyotid the right "afid of the Sccoll Window, 

If the Monitor Is called apm tft read from the keyfio^.tSV *t "eSli^ee" 
the input charaetePs Co the sGaseen. Injiut of a caajciag,*: Tet-ai.nj(. $ile- 
backspace Coo Etany, % ^■^&t taSssfln^t, 'sr ''4 'S'efnm al'e8'f4ft'i^.'~ISca?«* 
Key function will caufie, B^ti,a to W restoreii iy the- ttenltac to poitit 
witMn the primary dlapl^J* a^ea. 

In Che case rfiere one display area Is to be used for text and the 
6ther fur graphics, it is preferable Co keep the graphics in che 
prlmscy area and the Ceict in the secondary area because the Monitor 
jfaccalKi.ilttes GBAS1,,H continually for plotting functions, whereas for 
teXC tiDtpuE BASL.H Is recomputed only when It le necessary to move the 
cursor Eo a new line. 

It must be noted chat APPLLSOFT also does not (easily) support the 
secondary display area. APPLESOFT in RAM occupies that part of meraory, 
and then some. Firmware APPLESOFT places the program code in that 
memory space, unless special actions are taken. Those actions may be 
noted in the sample program, which uses APPLESOFT and the secondary 
display area. POKE 104,12 and 3027,0 before loading the program. 



ADDRESS TABLE 

Function 



Place cursor at line c&l (CH) 

(store A to CV and compute' BASL.H 
by Jl-lP to VTAB. 

Set BASL.H from Wad, WNELFT 
by call BASCALC and add WNDLFT^, 

Set BASL.H from A-reg and HKDLFX 
by call BASCALC and add WNDLFTi 

Set BASL,H to memory address fo^ 
left character of screen (not 
Window) of line In A-reg. 



Hex +Dec -Dec Monitor Registers 

Addr Addr Addr l^bel pestrpyfi^ 

FBSi 64347 -1189 TAB? 1 

'«44? -1087 BASCALC A 
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Function 



flm +I)eo -Dec Monitor Ti^iste-cS 
Addr Addr Addr Label lie^f.e^f>:^&A 



Mi^^- "-3ZS mwi- W 



Write byte in A-reg to screen at 

cursor (CV),CCH) using lUVFIiG and 

HU]:porting cursor move. 
Write byte In A-reg Co screen at 

(CV),(CH) with cursor move but 

not INVFLG. 
Monitor Command Processor MOVE 

routine. (AlL.tl) thru (AZL.H) la 

moved to (A4L,H) thru whatever. 
Monitor Command Processor GO entry. FEB6 fiSa^fi -330 GO A,X,Y,P 

Set PCL.H from AIL.H IE entered. & 
Can RESTORE, set all regs but S 5 FEB9 65209 
jm via PCL.H. 



PDF6 65^14 -SZZ- dOTJTZ none 



FE2C 65068 -468 MOVE A (Y=0) 



FEBC 65212 



-327 
-324 



DIRECT CONTROL ADDRESSES 

The lo] lowing table describes the methods of setting the hardware for 
display to various screen configurations by direct control rather than 
by calling the Monitor. For some of these Items there is no routine 
In tlie Monitor which could be called to perfora the function. 



Funct ion 



Method 



Set iGSA?Hii:-s di-a.plas' ^ae-- 

§e,t TEXT display mode. 

Set firaphlca mode to Full S&r^&ft- 

Saf HIXE.P aiAPHICS and wode* 

Set dlG^l^. t4, Sagev 

Set aieptay liEt- SeCWB^ia'E^f tm^' 

Clear .HIRES -'SSt toitBS Wdiii. 

Set HIRES Graphics mode. 

Set top line of Scroll Window. 

SfL left edge of Scroll Window. 

Scl uidth of Scroll Window. 

Set bottom line of Scroll Window. 



POKE 


-16304,0 


or 


STA C050 


POKE 


-16303,0 


o.r 


STA C051 


POKE 


-16302,0 


or 


STA C052 


■POKE 


-16301,0 


or 


STA C053 


POKE 


-16309,0 


or 


STA C054 


Joke 


-16299,0 


or 


STA C055 


SOKE 


-16298,0 


or 


STA C05ft 


?GKE 


-16297,0 


or 


STA C057 



PCke 3i, line-number (0-23) 
Bottom must be greater than top- 
POKE 32, column-number (0-39) 
Left edge + width not to exceed 40. 
POKE 33,number-of-columns (1-40), 
Left edge + width not to exceed 
POKE 35, line-number (1-24) 
Bottom mist be greater than top. 



CM 


16 


524 


WNDLFT 


32 


S20 


cu 


37 


$2 5 


WNDWDTE 


33 


S21 


GBASL.Il 


38-39 


S26-27 


WNDTOP 


34 


S22 






528-29 


WHDBTM 


35 


$23 


1 NVFLtS 


50 


$32 









INTEGER BASIC SAMPLE PROGRAM 



11 HEH USING MONITOR IIPVE TECHSIQOE 



19 mw IW: 

20 REfl HOVE 

21 POKE 60,0: POKE SI, 4: 

22 POKE 62,255: POKE 63,7: 

23 POKE 66,0: FOKE 67,8: 

25 POKE 71,0: 

26 POKE Sa.ii: 

27 POKE 59,254: 

28 CALL -327: 
29' RBKIffiN 



MJl BVpASa SUBROaTINES 

AREA 1 TO AREA 2 
Rm SET A1L,ll 
REM SET A2L,H 
REM SCT AIL.H 

RE^^ SKT Y-ft&G=0 

REM S2C 

EEH SFE 

REM DO TllE MOVE 



1000 REM PROGRAM START 

1091 IF PEEK (75X12 THEN 32000 

UO0 CALL -936: REM C.LEAP, TliE SCREEN 

tiii^,. PRINT "THIS IS- IHE' SECOHBAEY DTSfIA? Jmk" 
iit^ ?RtNT "SbTE THE UCK (JF ,CORS0r" 

13^3 t^^s-.zq-. sm mm to secomdary 

14(J(J CtfeAR PRIHARY AGAIN 

1410 PRINT "THIS IS THE HilMARY AREA AGAIN" 
1500 POKE -16299,0: REM SET SECONDARY 

1600 FOR 1=1 TO '1000: NEXT I 

1700 POKE -16300,0: REM BACK TO PRIMARY 

32000 REM NO LOMEM ERROR 

32001 PRINT "PLEASE LOAD AGAIN" 

32003 PRINT "AFTER uma5:3072 " 
32003 END 



APPLESOFT SAMPLE PROGRAM 



10 RE!1 SECONDARY DISPLAY AREA WJS AHD MEANS 

11 REM SAMPLF. PHOGRAit 

12 REM READS FROt*' fe^OASI* 

13 EEM c/xmmiHr cw:, (m^^'^v^, stoikg 
14- REM AND nMn's im s-$RiBe 

1009 W 'mc&WAM'' Msk 'dJjat? 



1010 IF TSm illfii) < 12 THEN 62000 
1020 <x>Sm, REt' ci,EAR THE SBCOHDftRY 
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REM MAIN P R G !i A ri 



1 iW0 


IF Q = 3 THEN IJ9(S: 


REM 


INPbT TO PRIMARY 


1 




REfl 




1 M0 


POKE 37,21: 


REH 


SET T.TNE 21 


nil 


CALL - 990: 


Era 


STT RASI H 


1312 


POKE 41, PEEK (41> + 4: 


REM 


SET RASM TO '■FGONriARY 


n9g 


LIPUT CC$,LI,CL,SSS 








IF CC$ - "KND" THEN 63900 






IF CCS = "s" '-TflEH Mmr 


Rm 






ZF-- 19% -■ "s" 1WK im-. 


REM 


SET IHOU TO PRIMARY ARPA 




Ci;$. - ■*^" THEN 2200: 


REM 


SET INPUT SECONDARY 


iwi 


IF ecS - "R" THEN 2300: 


REM 


SET INPUT PR TMARY 


[44'^ 


IF CG$ = "X" THEN 1500: 


REH 




1 4')0 


POKE 16300,0: PRINT "WHAT? " 




1 'i00 


SI, = LEH (SSS) 






1510 


IF M > 23 THEN 1810 






1 M 1 


IF CT, > 39 THEN 1810 






I '1 1 2 


[F n + ST ■> It TIIKN SI 


40 


- CL: REM NO AUTO CR 


1 'j90 


CX = PEEK (37): 


RfiM 


r?:memrek gv 


1 (.00 


POKF 37, LI: CALL - 990 


: POKE 41, PEF^K (4!) +4 


1 fiiy 


POKE 37, CX: 


REM 


RESTORE CV 


1 Ii20 


POKE 36,CLr 


REM 


SET Ca TOR THIS PRINT 


1 /iMi 


SPS = LEFTS .(^ffivSL): 


RSM 


SHORTES miMT IH THIS SMPL 


1 /n» 


PRINT SP$ 






1 HWM 


GOTO 1300 






] HI ^ 


CAJ,L - 936! 


im VALUE TOO LARfK.' 




PRIte "mf M BIG"; 


Sat 


n.m iH pRTJiw 


I HI 2 


PRINT "M "r-LIj PRINT " 


IH ";-CL 


lfl20 


GOTfl 130.0 






im 




WH 


SET SECONDARY 




goto; 1300 






POKE - 16300,0; 


REH 


SET miMARY 


21 11* 


COTO 1300 






Z200 


0=1: GOTO 1300: 


REM 


SET MPirr TO SECONDARY 


a 100 


q " (/! GOTO 1300! 




SET INFIIT TO HtlMARi 
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62000 PRINT "SKTUP NOT HADK , MOW BEING DOME" 

620ia i'RINT "RUN THK TOOGTiAll AGAIN" 

RFM 104 IS APPLESOFT ROM .'TTARr 
62319 RKM. BYTE BEFORR SC01 MUST BE ZERO 

62020 POKE 3072,0: POKE 104,12: END 

G3300 BL$ = " REM aEAR .■ffiGQHDARY ARBA 

63001 FOR I = 1 TO 3:BLg - 51.S + BLS ! NEXT 

63905 CX = PEEK (37) 

63010 FOR I = TO 23 

63023 POKE 37, T: dAU - 990 

5^33 POKE ?EEK + 4 

63043 POKE 3^,.0 

636[50 PRTM- 'K.^ 

63(^,60 NSrr " 

63070 POKE 37,C3C! POKE 36^0 

63080 RETURN 

63900 POKE 16100,0; CALL - 1233: m> 
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CHAPTER 3 

INTERRUPT PROCESSING 

Some coagu?®*?-" s^R&^-l^: of' ceaotlTig- to' ttie mlaio^ (or dropping,) of 
n slfinal line instantly ^awftig the tiit'tfenE ^fcafofe di tttei piwc^&atit, 
.111,1 ijiilijJelj' 'transferrins control to Gone other prosram within Xbe 
.■i.inpiicer. thanglna the state of that line Is called "causing an 
tiitrrnipc". The functions of the processor In saving its current state 
jiiul t rjinsfevring control to some other location in meniory is called 
"tMlMiii; .-m incerrupt". The program which then recefves control 1b. 

rd 1(1 "handle the Interrupt". 

Mil- i/ifl2 microprocessor in the Apple II i'; sensitive to three 
InliTrupc categories. These are RESET, NHl (Non-Maskable Interrupt), 
mid IRQ. Execution of a BRK Instruction causes a form of IRQ interrupt 
to he simulated. 



Till' purpose of an interrupt. In general. Is to allow some kind of 
_ 1^^— I'xLornal device to make a condition known to a running program without 
fc-^^BB Che program having to periodically or continually test for the 

haNvape. eondltlon. An exampie 'ot .the latter t^pa of cpetatlon iff the 
U Aptile- II keyboard op«ratlOft!, '^en ItiplC- 66 he ^$S4^p^e:6 

I j^etmry location $c000 is tested rggtf^t^iily tni?>U iire^ejiee 1^. sign 

hit iwdicates that a T<ey tiss' SSKEf p»e^ect> -Aa .eJiampie int&tT.iept 
dfl'VPil .prpEcRglng could be S Bpi^ja'l Jie*tiitiec^l C95t?'.^ll?B'fi ®acd, 
nirtffKfied t» .a telephone line,, whieh -caused ths .eompttter te .1)6 .taketi. 
C .^1^1 n»er hy a ^Ata ac^itsft't'Ofl -Jir^:^W *ft^ ^lie Slft*'^. available, but 
"""^^ wovilil . allow the machine; tea "bfe ased jiai st^i^t t^iS^^- Sn between 
I rnnflittl'Baidns. 



Whi-ii .T conipuceT recognises C-tafces) an Interrupt, the hardware should 
Jii-.-ompl I sh three things. 

1. Save processor status in such a way that eKecutlon of the 
t interrupted progran can he cqtitlnued af.tet the interrupt has 

been "itjrviced" or handled. 

2. Prevent further recognition of that class of interrupts until 
the Inte-rrupt handling pfagram rastotes that interrupt ability. 

3. Transfer control to the program meant to handle this- type oc 
cateRory of interrupt. 

^ i-'i^ ti50.2 in the Apple II v^^ABtlafig- ijn the ahijve t)iy,^' ^tejta are 



k. U iSiien an IRQ Cor BRK> or NHI Interrupt feak-en> the .e^iateSts- ,o£ 

" I t-he prfigroin counter %Ti& Ei>& F-reg (ft^oe'es^fiJ? S**t^: -^.fstec) 

are- respectively pu^^ oato the staeSi When -a RfiSET Inii'^rrupt 
la ta)(«n-, S!ie pcog^ssor h^l^S tha -mwn^ RpAE mode until 
control J-s traiiSf et-red CO the tiandler, so nothing of processor 
status Is pushed onto the stgefc'. 
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2. When tli« 6502 takes an IRQ interrupt, the P-reg is modified. If 
a BRK instruction is executed, the $19 bit oi the processor 
status register set to one before th&. P-reg Is pushed onto 
the stack. If the IRQ line was the cause of the interrapt, thle 
bit la BRC ta. z6to before the P-reg Is pushed onto tbe stack. 

MV^t tSle :P-^e> l£i -Stl^SSd JtaCd stack, the hit Is set to 

i(>hlbl* EecogaAtlon of an^ ino-ije ZB^j; ea't^ory interrupts until 
ih-^ Jntdri^'pc hsinaiHig tiifogtaitt c'ltea^g tjiis eondittoft. 

With RESET and mil there is no available facility Ear 
preventing another interrupt while the current interrupt ts 

being handled • 

3. The 6502 transfers control to the appropriate program for 
handling an interrupt by means of "vectors". Memory addressee 
$FFFfl-SF"FFF are reserved for this purpose. The final step of 
takinK an intE^rnipt is loading of the program connter from tlie 
vector for this class or category of Interrupt. The following 
table indicates the IScatioiifi of the Interrupt handlers for the 
two Ilonltors. 

Interrupt Vector Monitor Old Monitor Autostart 
Taken, Address Label Address Address 

HMI SFFFA-B "NHI" ~lpFB~ S^IIFb" 

RESET SFFFC-D RESE1 5F^59 $FA62 

lEQ/BRK $KPFE-F IRQ SFA40 

NMI INTERRUPT 

Tlie Apple II Monitor does not Interfere witli u.ser handling of 
the NMI interrupt. That is, the vector for NMl causes the 6502 
to ttuviSi^T control of the computer to location S^fSFB, where 
t>ie user is to place a JHP to the user-provided handler for 
this type of Iriterrupt. 

RESET INTERRUPT SUPPORT 

Pressing the RESET key on the keyboard causes a RESET interrupt 
to occur. On all Apple II's but the very early ones, power-on 
also results in generation of a RESET interrupt. 

ttee. actfens performed by the Autostart ^fpilitpc and the Old 
HfijilMi' fBSET iaterrupt ^jtsttsr^ 'pffe i^nst^raljly' di??f«rettt-. 
TTierefoTCj they 'vlll be de^rlbed BeparStel?- 
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IRQ/BRK INTERRUPT HANDLING 



When either an IRQ interrupt is taken or a BRK Instruction is 
executed, the 6.'j02 performs an interrvipt sequence. The contents 
of the program counter are inished onto the stack. The 910 bit 
of the P-reg i;; set or cleared to indicate the IRQ line vs. 
BRK instruction, and then it is pushed onto the StacV. The 65M 
then sets the S(i4 bit of the P-reg, preventing another 
interrupt of this type from being recognized until this one is 
handled. The 65,g2 then loads the Pro^p^jn Counter froni the IRQ 
hardwaie jnsesc^be^ WeCtor at SFFFE-SB'^Ft', arri .alio™, operation 
oE the computer to contlTiuc frpp that point. The Inter jrupt 
Handler for IRQ interrupts is mar in control-. 



RESET INTERRUPT— ©10 MONITOR 

When <i RESET interrupt is taken the Old Monitor establishes a 
predefined configuration of hardware and page zero fields. Primarily, 
I ho keyboard is set as the current Input device, the screen is set as 
I liv rnrtent output device, and the screen configuration Is set Co full 
Scroll Window with normal video. 

\'. <!'.'-■ xero fields KSWL,II, CSWL,H are set to make the keyboard and 
'aix'fn active. WNDLFT, \JNDHDTH, WNDTOP , WNDBTM arc set to define the 
wliolr screen as the Scroll Window. CV and CH are set to place the 
cuTHur at the bottom left corner .of the screen. TNVFLG la set to 
normal (white on black). 

Hardware (iddresses are referenced to establish a knovn configuration 

^(:056 — cleaT' high Resolution graplilcs 
^054 ~ display prlTiiary area 
'$,€0^1 - set text mode 

ttont*^!. is jhen transferred to the "top" of tlie Monitor at label MON, 
l-Geati^^ $F?65, sa^, K^ilci paXjit, thp "bpH" is sounded and the Monitor 
nnte'ra the conanand line keaS toufclne* 
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ADDRESS TABLE 



Function 


Hex 


+Dei: 


-Dec 


Monitor Registers; 




Addr 


Addr 


Addr 


Lfibel Dosi t niyed 


Se.t ,STA1'U^ Ifi S4yE ,ai:e3 to ii. 






-1253 


IN IT 


A 


Clear; ai^^S-, 




-122^ 




A 


Set jSc^lEiftpy display acea. 


■8 SS3$. 


64310 


-1226 




A 






64313 


-1223 


01.1 iM. 


A 


■Set fall s^tsiin sfi^pii 'sjtnilew 




6A31,6 


-1221? 




A 














jaSQl^p ■fton-A-reg. 


& 


64331 


-1205 


aijlnt*'' 




iiiad A w^'th (J for WNDLFT. 


G FB4D 


64333 


-1203 




A 


Set WhfDLFT from A-reg. 


£ FB4f 


64335 


-1201 




A 


Load A with 40 for WHDWDTH. 


S FB51 


64337 


-1 199 




A 


Set T#1DWDTH from A-rtg . 


fi FB53 


64339 


-1197 




A 


l.nai\ A with 24 fnr HNDBTH. 


!• FB55 


64341 


-1 195 




A 


Set WNDBTM from A-reg. 


& FB57 


64343 


-1193 






LoacJ A with 23 for CV. 




64345 


-1191 




* 
A 


Sec CV from A-reg. 


fi FB5B 


64J47 


-nag 


TABV 


A 


JMP to VTAn to set MSL.H & RTS. 


FBSD 


M349 


-1187 




A 


Set INVFLG to SFF = normal Video. 


FE84 


65156 


-380 


LJji 1 ML' 1^] 1 


Y 


Set INVFLG from "i-reg. 


FF„S6 


6515R 


-378 




no Tie 


Set port (keyboard) for Input. 


FE89 


65161 


-375 




V V 

, A , 1 


Set port 9 (screen) for output. 


FR93 


65171 


-365 


D J. V 1 D 


A. Y V 


Honitor entry on RESET key pre.^sed Fl''^? 


65369 


-167 


REr;!i3: 




or Power on. 












Gail SETNCKI} - white an Uack, 












C*H t-Siar -T'ext £all scroll. 






-16i 






Call SETVIB - Ss;T;efiM S'S 






-1^.1 






Call SETKBto - "t!«5?Si>ard " taimfc. 


& FF«2 




-isr 






Glmt Mm aecimaJ laode (set bex) & ?F6-5 




-ISS 


tow 






&■ tm& 




--15fi 






}^pniSi^ Comnaad Procesaor Entry. 


FF69 


65385 


-151 






Set" as prompt character. 













RESET INTERRUPT— AUTOSTART MONITOR 

The Autostart Honitor performs functions of three categories in 
handling a EESET interrupt, 

1. Establish a known hardware/ software envlroiteent HiEh reBacd;; t6 
the basic machine. 

2. If the cgntents of inemory (page three) do not indicate th^t a 
p'5>fgt-iitn lftl^:^al.j-astei-pati: S^s \&^rt .perjEOfiaea,,, the JiiCoBtact 
Monitor sSLll perform power'-un' InltJraitza ti?m.- A .dISfe 
fe^h-trolISP card is present In mte of -Che slot^^j -power-on 
Initialization Includes bootstrapping from that slot. If no 
disk controller card Is in the machine a control— B entry is 
simulated. In either ease, the appropriate language process-or 



f- in 




receives control at the end of power-on init ialiration , with 
page three Eielda Hct to indicate that a wann start is to be 
performed on engulng in.terru.pts from the RISET Wy. 

3. If the contents of memory (page three) indicate that power— On 
Initialisation, has already been perforBed^ the Autostart 
Honitor -igix "cif-mfS-et cojitrot Ktfe' B$^'KT (%fc %ti:0 vector- 
In pag® e6r-6g, at ttv^- ei;iiiclu6ioo -of "^amiliim" the E^il^ 
tttt-«?tttpt^i If ETOS 'tiafe 'been tooiaa, t1ii& «111 result 1-n transFet 
i>£ centrol back to the current language firaeM^^-tit fito^iugh D|5S. 
Xf .DBS is no.t present, the normal settli^ of tW.J^^ET weetor 
will GSWBS, 5inWlatl^>!l a control-C twartn start) t^ntrf into 
the ciirretit language'. 



INITIALIZE SYSTEM CONFIGURATION 

Wlii'n a RESET interrupt is taken, the Autostart Ifonitpr establishes a 
pre^e^inM catifi^ioeaW-Bii ioS" ftsriwai^ Sn* 'p^e 3ei§ fifllds. Primarily, 
Lhp k«yboara Is set: as the eti.E^^nfc it^uS. ^^^g^, th6 screen is set as 
tlic current output device, atdi iifiRj sci-«&ft eiSif fgiufStion is set to full 
screen Scroll, Wiii;de^ Vi'is^i no*fial 

Fdfie ze-re fieltln ^5n..H, S-se s^t to make the kejhyard and 

MiTeen active. WNQIM^, HHMffil'H, ' ifflltiTtfP, li3*QS'm are set to define the 
whiih' screen as the Stroll Window. CV and CH are set to place the 
lursor at the bottom l&ft corner of the screen. INVFLG i'S Set to 
fiiirraiil (white on hlack),. 

ilii I (Iw.i ! addrasfies are referenced, to estahlish a known configuration 

.ih ( I I I low. 

- clear high resolution graphics 
■ I i/l'i'i - display primaiy area 
■..cl^'il - si'C tCKt mode 
;;ri/',J( - rlc.-ir AN0 = TTL M 
fCH'iA - rlear AKl - TTL 10 

~ r.pX AH2 = TTL JII 
^Ctl'jF - ,set AN3 = TTL JII 
fCh'Ki' - mrin off Fxp«nsf-on sdi 
%S:'Miii - clear te^htKi-r* *t"-r,Gibe- 

l!n I'omph'tiori of all tfe abtwe, the Aytostatt Iforiit'o-r Soulids thfe BELL. 



COLD/WARM DETERMINATION 

Allcr I'fiLiiliHuhinp a knpyn h^sic hardware and so,ftwar^ (screen 

eoftiKilff) eiwttWSie'i>i;,, the Ao.Cosxart Honitor fflseeitt.^- ^ teat 

(li'l criTiliic' wlietheT powe«-Sin Jitlil.slissati'on Is. 'to fe^ Vt^rfoTO^- Tage 

/iililrr«« tii which in« .AwtostS'ft Jlijriitt^ sJill >t'ifatvSt^,f eoivtrdl m 
i-i.miili'.i" ton fif handling the SF.&:Kf iMe'f&i^>«- teG.'StlliTt is- a 
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validation "byte, (ies!!^ with PifiFS to indlcatt whetbpr or not pfiw(?r--oii 
Initialization is to hs perEormed. Tf tha Exclusive OR of the coiiCenC!! 
of thesp tw-o memory locations is SA5, tlien power-oii initialization (b 
considered to have been previously accomplished, and $03F2-S0.'iF3 is 
considered a vall^ address to vAiich to cransfet" controls 

POWER-ON INITIALIZATION 

"Ttie fiirsE -fun'G.ttons of power-on inttlall?atJ on ^ts tit estahlish in 

thfee (503ffl-g03F4) Che BRK latecr«ft wect^gr (see "bRK 
Insttuction Handling - Autostart Monitor") and the RESET Soft Entry 
Interrupt vector with valldatiovi byte. The RESET vector at this ()olnt 

is set CO 5E00(J to simulate a control-R (Initiaiize) entry for the 
Current lat^u-age processor. 

The Autostart Monitor next performs n routine which tests each clot, 
from sltst 7 through slot 1, £or presence of a disk controller card. 
If one is found, a jump is perfonaed to $CX00 where X is the slot 
number in which the disk controller has been found. This idll result 
in Ipading of DOS and presumably execution of tVie HELLO program. 
Sate-: DOS 3.2 Replaces the RESET vector at S03F2-S03F3 and validation 
byfea at S33F4, BO that on a RESET Interi'upt, control will be pseseil 
t-h-EOugh DOS back to the cofK-ent i^in^fiB ^ppcs,e.^a^. 

.t¥< -no- disfe ^oalmi'ifii' mx4 i*f fei^' ta^ ItoS-A^seiart p|osit^OE ehangea tte 
li,BSET .ifeijttir pO'0$Si Clangua-ge rijB^rt Cir 'cVnt-rtfl-O, entry iwint). 
then Jumps to $E000' ClanRuaBe Initialize entry point). 

SYSTEM RESTART 

If the S03F3-S03E4 test described above Is passed, the RESET vectnr at 
3(33F2-$03F3 is comldered mostly valid. If it contijins SE00a, it is 

changed to SE0(i3 and' tetie* J&SSIC is entered at $FM9- If It is not 
5E01i!^,, \t, executes aa Indirect Jump via Sfl3F2-S03F3 to the addteSa 
specWieti therein. 

RESET VECTOR MODIFICATION BY USER 

The RESET vector may be imidified by aser or program to send control to 
some other address in the machine at the completion of Monitor 
handling of the interrupt. For example, ta .caw^e, the RESET k^j; za 
result in pS-k^^inl^ the fiachine in Honitoc wS'iEp.j, Etseeate t^e foilWtag 
program; 

m JOKE i0 m^m 

it 15(11,255 
30 POKE 1012,90 

40 CALL -151: RIM RNTER MONITOR 
5@ BSD 
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'I'lif following program is miro general purpose. In order to set the 
m;si:'r vector to some address, poke Che address into locatiosis 101p- 
iKll (S03i.-2-S«3F3) and then CALL Autostart Hoiiitor label SE1TWRC 
(^I'lMiK or 64357 or -1169) to set location 1012 CS03F4,1. 

10 RKM AD IS ADMESS OF 
I I nm ROUTIKE TO RECEIVE 

I v. \im CONTROL AFTER, ESS^^T 
■/.l/l i'OKR 1010, AH: l®t SEf tCf 
m I'OKE 10H,^AlV2Set REM SET RI 
/.0 ^lALL -nS9! 8Sp SET 1012' 

Wote: Ef you. t.r^ tiS laa tTila OB a system with an Old Monitor ROM, you 

ra!l-y 4*b:c*^. im 'j^i^^T-M., tip -even the entire disketre. To avoid this 
probtem, execnt^ tfe sre"p'g' ifi the above program manually, on a system 
with m ATito.=.-( art ROM, Tlien, PF.RK location 1012 and ^eC the ualue to 
I'UKI': into it^l2, alleviating the need to CALL-1169 at all. 



ADDRESS TABLE 



Timet ton 



Hex +T)ec -Deo Monitor Registers 
Ar;Mr Addr Addr Label Destroy^i! 




I'i.Mlior entry on lif^SET key pressed 

III 1 'd iwi^ P" OTl . 

la.l) - clear 6502 dec, (set hex). 

\ I :;i:TNORli - white on black. 
Cjill IMIT - Text, full scroll. 
C^ill SETVID - screen as output. 
SETKBD - keyboard aa input 
Initialise hardware to known state. 
Cinar AHI^ t« TT.L LQ (ref . 
(:ie*if ftSl .to ^n. 14- ttdt -'-—^ 
■set "ITI.. HI 'Cref. ■C&SBJv &■ 

clpnr Rf:pa.n34.&n: (ref^ & 
CAe'T key'feoatfj StwW. S 
ClcMr fi502 .d«clTiiaI siode (set hex).;; 

I'di I m.\.. & 

r,"i( !rit-3 wn. S3F4: Cold or Wam 
1 1 Col d ).,o;o ?Wr;[p. 
H (■S3F'!) xriH - 3A5, UHrm. 

Trrit ;;'f|-'I'I:V {S3I'-2) low byte: 
Niiiiv.i'i.i iiir.ins Cold Start done - 
Ciiiii NOl'lX U-i iiso SOFri'^V vector. 
I M nicMjiM rt-u t a rl" w.'J rrn maybe . 
Triir :;nMi.A' lil i-or SR0 - language 
lit .'M't ..iicry. If not equal , 
:-'irii:v 1h ok to use, goto nofix. 
■;(!lii'i:v - SKlS00, i-liange to SE003 for 
ImImi'i: iirte find KOto 5E000 ta cold 
Htiiri thf Iiiiigu;i|^e . 



FA62 64098 -1438 RESET 



FA63 
FA&6 
FA69 
FA6C 



.^5 

?A\?a. 

FATK 

FA81 

FAB5' 



64099 
64102 
64105 
64108 

aiii 

Mll?5 

64120 
64123 
64126 
64 1 29 
64130 
64133 



-1437 
-143i 

-1431 
-U28 

-1425 IKlTiUJ 

-1416 
-1413 
-1410 

-1 4tl7 NEWM0N 

-1406 

-1403 



FARF 64143 -1393 



FA94 64148 -1588 



FA9B 64155 -13S1 FIXSCT 
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■Function 



Hex +Tlec -Dec Hon ! tor Res;l stei";^ 
Addr Adrir Adrfr l.iibel Destroyed 



JMP (FnFTIW): (lae tiie Soft Entry 
vector to exit RESSF.T handler. 

Cold Start on REKCT entry point. 
Call APPLRII to clear screen -aiid 
put title on top line. & 

Set f>ag<i 3 interrupt vectors for 
BkK (OLDBRK) and SOFTEV CSE0(fl0). 

took for disk controller card in 
slots 7 thru 1, I£ nop*,, '^O^O. 
FIXSEV above to SOIT^B?f -Iqr 
feASrC s«scaKt 'feiit^r lfc*§IS, 'K^M- 
if dlsic- f-Dund, JSP- (LljSlS) to feoot 
from the disk. 

Clear screen (call HOME). & 

Place APPLE II legend on top line. 

Set PWREDUP ($3F4) = (S3F3) XOR $A5' 



EAA3 
FAA6 

FAB4 



Set STATUS In SAVE area to 0. 
Clear HIRES. 

Set priisary display area. 
Set T!iXT mode. 

Set full Kcrecii scroll window by 

branch to SETONn with CA)=0. 
Set WNDTOl' ""rom A-reg. 
Load A with (J for WDT.ET. 
Set UHDLFT from A-rep,. 

Load A with 40 for tJNDWDT!!. 
Set WNDUIITH from A-reR. 

Load A with 24 for IfflDBTM. 
Set WNDBTll from A-reg. 
Load A with 23 for CV. 

g^t ISpW to* ^FF = :n«^I»l' Video. 
S,et IHVFLG from Y-reg. 
Set poet 3 (keyhoard) So* input. 
Set port tSGTBe:n.) for output. 



FB2F 
FB35 
FB36 
FB39 
FB3C 

FB4b 
FB4n 
KB4F 

FB51 
FB53 

FB-^^ 
FB37 
FB59 



FE-93 



FQR COMPAt-Mltai^: WITH tH^D MONITCHi FF59 
the RESEt routine Is still here. 



64163 -1373 MOEIX 

-1370 PWPUP 

M169 -1567 SETPG3 
-1356 



643;J3 -1Z33 INII A 

643(37 -1229 A 

64310 -1226 A 

64313 "1223 SETTXT A 

6431 & -1 220 A 

64331 -1203 SEIVIJD A 

64333 -1203 A 

ji433,'5 -1201 A 

64.137 -1199 A 

64339 -1197 A 

64341 -119'; A 

64343 -1193 A 

64345 -1191 A 

64347 -1189 TABV it 

-1 187 A 

^tU- -383 ssmeigi 

$5! n -365 SETfLD A, X,Y 

45369 -167 O.LmST 



Call 


SETNORH - white on black. 


& 










Call 


INIT -Text fi full scroll. 


& 


FF5C 


6.'5372 


-164 




Call 


SETVID - screen as output. 


5, 


FF3F 


65375 


-161 




Call 


SETKBD - keyboard = input. 


f, 


FF62 


6537 8 


-158 




Clear 


6')02 declwa:! Dibde,5ec "hex. 


f. 


FF65 


65381 


-155 


MOfI 


Sound 


bell. 




FF66 


65382 


-154 




Monitor Corafiand Processor Kntry. 




FP59 


^53 as 


-151 





Set "*" as prompt charactei-. 
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IRQ/BRK INTERRUPTS 



IRQ/BRK INTERRUPT RECOGNITION 

When eitfi&r an IRQ Interrupt is taken or a. SSK, i,i^lr«iie«lon Is .executed 
the fe5(?'Z performs an. litEfermpt afequence. Xij^ c*itHe&fca Hf -"t^% ptc^r^- 
phmtet ac'g ftu^ttiM! ^tlta. tte stack. Tlj-e ^'iX f£ the P-reg is »r 
r-teared iti Itoilc^tton of IRQ line vS. BW^' Cn'St-i^iifetlon, and then ft Is 
puHhcrf onto the stack. The 6502 then aeta the $(S4 bit of P-reg, 
urcvcntlnj; another interrupt of this type from being recognized until 
lIiIh one is handled. Tlie 6502 then loads the ProRtam l^ounter from the 
1 K() h.irdwarc prescribed vector at SFFFE-SFl''l''F , and allows operation of 
the coraputer to continue from that point. The Interrupt Handler for 
T K() Interrupts Is now in control. 

IRQ INTERRUPT HANDLING 

The 6502 ■4ifcecilng vectof ^ESW-^FTF W». ?6c>«ie^ gc^K^a 

Inhtl 1^ 1-n betli ehe SU t(iHl%rit ^1(3 the Mtimi'^H iMiitit: 'Xt will 
he noted In t1i6 addpesa t#tt^ tft'aj; -^^ipss^, t& ^Itfeient, limmver. 

Thi> h;indllng of an IRQ intei'ljpigt; Is identical In both Monitors, llie 
['(intents of the A-reg are atore^ at ACC (Si5) for future reference. 
the iB'ocessor statvif; (P-reg) pushed onto the stack by the taking of 
I he Interrupt is popped Into the A-reg, and then pushed back onto the 
rii;irk no that the stack and pointer arc not changed. By shifting the 
A-rcf' left three bits, the IRQ routine moves into the sign bit the bit 
wMi b ImMcates (in this case by being a zero) that the interrvipt la 
Jill 11(1) fiUorrupt rather than execution of a liRK instruction. The 
IliiiHlor iIkmi tKecutCE a Jump Indirect instruction via location 
'■0 ll'l'' to the user provided IRQ Interrupt handler. Note that on an IRQ 
liii.-ini|it the X, Y, nnd S registers are no! saved by the Monitor. 
A 1 no , Che interrupt handler has the responsibility ,of clearing the $04 
bit nn e:ilt to allow further interrupts* 

BRK INSTRUCTION INTERRUPT 

llsiTMi 1 [111 of ,1 lifiK Instruction causes the 6502 to simulate an IRQ 
I lU iM- rii[i( wi t li minor changes. IXie to the method the instruction la 
tifiiiiMi'd, the address pushed onto the stack as parr of the Interrupt 
B Imiil at l"n 13 two bytas beyond the BRK instruction ^ticecuted. 

tlc'hiri' iiiishini; the P— reg onto the stack, the ^10 bit is Set to 
Inilli'iili' \ii I hi' Interrupt handling routine that the cause of the 
I 111 IT ru|jl cxfcnt Ion of a BRK instruction rather than the IR(J line. 

AM I'l i>iii!h 1 rif, I be P-reg onto the stack, the $04 bit is set to inhibit 
1 1( I ? ! n r I'M"! I |i [ s Iron bel ng recognized tint 11 Che interrupt handler 
i lciirii I hi' <:ondltinn. Control Is' tJren transferred according to the 
IHl) Intrrrupt vector to MoBlttor' label IRQ. As deso?lb^4 SbiJ^- 
reRHFdtnii; handllnj^ of an IRQ interrupt, the IRQ routine first B&ir.es 
the ft-reK .ft C$^55 for future reference, and then uses tfee "Ss-K^g. 

ii. test th* sticked P-teg, eonteots tot a one In the S10 jjia^t-ifen, -'^0 
Hliil-k nnd AtaGk ^ittte* -aVfi ticrt cHas^ed 'hj? l,hlS -^e-r^tiim.. fhe reptilt 
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■of the test is a Crsnefer of control to Monitor label BREAK. Note In 

the address table Chat the address of BREAK is nut the name In the two 

BRK INSTRUCTION-SAVING OF STATUS 

IM feaiclj ^ItipJpBr thfe 'fi-t^ W*ng doited in the BREAK routine fa" to sa^e 
full mae^ltne. status in pa^^ zero. The contents of the A-reg have 
already- been stored by ertC-ry into the IRc; interrupt handler. The BRKAK 
routine pops the stacked contentE of the P-reg from the stack, and 
does a JSR to SAVl at which, point the remaining registers are saved. 
Nate that this clears the Sfli bit, allowing further lEQ or BRK 
Interrupts to be taken. The S-reg saved at that tine, however, haH 
been Incremented once by popping the P-reg back from the stack and 
decremented twice by the JSR to SAVl. On return from SAVl, the BREAK 
routine pops the Prograrn Cou.nter from the stack and stores it In page 
zero locations PCL-PCH. The address table at the end of this section 
iEiilcates the page zero locations at "sriiith the above items are stored. 



BRK INSTRUCTION-OLD MONITOR 

The function of the BEK instruction Interrupt handler of the Old 
Monitor is to display through COUT the machine status at the time the 
BEK Instruction was encountered, and then return control to the top of 
the Monitor at label TIOH. Tho rfetails above describe the handling of 

the Interrupt through storajje of machine status 1ti pa^e Zero, 
IncludinR PCL,H. The ofd Monitor KPF.AK routine next does a j!^R to 
TNSDSI to aisplay the instruction at the address indicated hy PCL-PCH 
(which is two bytes beynnd the BRK executed), and a JBH to RC.DSPl to 
display the contents of the five registers, P, A, X, Y, S. Note that 
the E-r6R as displayed is two less than it was at the time of the BRK. 
est^to-uftl4« M ■t^j: ^ii^X. an ^"Bnipl^ticni «if the e^iaj^t 

■Axaplay, a jMF to flON completea the han^Jllng of the Interrupt. 

BRK l^fS^mx;TIOM-AUT0SMT mgjnitor 

The Autostart tfoniLor bandies IR(} interrupt which is really a BRK 
instruction interrupt by saving registers and Pcograin Counter In page. 
Z&ta locations. The Autostart Monitor BREAK routine then exits wia Ske 
Apple-II BREAK vector at $03F0-S03f1. Thus, it Is possible for a mei 
program to gain control at that point and do somethine other tba« ta 
display the registers and r^tur.a to th© ISfnitoE' comrajlml laro.Geseofe, 
Such a program must be sofft to clear tlie W "bit ia t'^e P'-reg an 
r,«turo. fluting RESET interrupt tandllng for power-on, this vector la 
lirttlallEed ta point at Autostart Monitor label OLDBRK, which routine 
does tlie same thing as was done in Old Monitor. That is, it does a JSR 
to INSDSI CO display the disassembled instruction at the location 
Indicated by PCL- PCH, a JSE to RCDSPi to display the register 
contents, and a JMP to MON to complete the handling of the Interrupt, 
rfote: after DOS 3.2 has destroyed pap,e ^ during the bootstrap 
operation. It restores this vector to point to $FA59, OLDBRK. 
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ADDRESS TABLE 



Fiinct'Ifln 



DiaaaseBlWe tha Inatryct^on at 

t'pQL,ft).. priTiE mti "mi' " 

Uispla^. ■e^-l.st-.er^ thru COUt from 
t'B'v'i ar^a, after carriage retnrn. 
Display regisfecs thru COUT from 

save area. 
Save 6502 regs at S45-49. 

ACC $i,5. 



Save A-reg at 

Save X-reg at XRKC 

Save Y-rej; at YREC $47. 

Save P-reg at 

S^ivc S-reR at 



STATUS $48, 
SPHT $49. 

Clo.-ir 6302 deciraal mode (set hnx). 

Clear 6^)02 decimal moda (set hex) f, 
Sound bell . s 
Monitor Command Processor Entcy. 
Set "*" as. j«-orapt character. 



ffiK -Det MisrtltoTlEegistera 

Addr Addr Addir I^bel Destroyed 

P^SB? -mif: INSTDSP A,X.Y 

FAD7 64215 -1321 KSGDS? A,X 

FADA 64218 -1318 EiJDSPI A,X: 

FF4a 65354 -laa SAVE A,x 

FF4C fi535fi -181^ SAn 

FF4e 65358 -178 

FF50 65360 -176 

FF54 65364 -172 

FF65 65381 -155 MON 

FF66 65382 -154 

FF69 65385 -151 yio^z 



Q^^t«i,r^ Mh^th«r iWsfj'tiiSt was 
Xrt13 M SgS. .fetansfer control 

Handle BRX interrupt: 
Reetote P-reg from stack. 
Save registe-ES tp&Vl) X^Y.S.^S. 
Move Interrupt lota'tfo'ti Item stack 

to PCL,H. ^ 
JMP (BRKV) to possibly user 

specified routine (normally to 

OLDBRK, below). 
Default RRK interrupt handler FA59 
completion routine 

lllsplay instruction (2 bytes pae-C), 
Display registers, JMP to MON. 



FA40 64364 -1A7Z IRQ 



FA4C 64:076 -1460 BREAK A.X.V 



OLD MONITOR IRQ/BRK HANDLING 

Determine idiether Interrupt 'was 
IRQ or BRK, transfer control 
accordlu^ly.. 

Handle HIlK int.esriipt"! 
SaiTe 't«g.isCers.y 
feieplay instfuctton ('^ Vses- ^laBt), 
"Qispiiiy fe^#fre-r», -MP to tm. 



64()89 -1447 GLBBHK A,X,Y 



FA86 64134 -14(J2 IRQ 



Ui^t -139^ mm A,x,Y 



PCI.H 

ACG 

XREG 



58,59 



33a, 3B 

S45 

S46 



~wm- 71 S47 
YS'ft?' 52 S34 
STAIUS 72 $48 



INTERRUPT PROCESSING 63 



CHAPTER 4 

MISCELLANY 

MACHIHE lAM^UAGE DEVELOPMENT AIDS 

riii-if .trt' many routiaes in the Monitor whi'cli can he hplpFul when 
(li'ueJop i iif; machine lanjjua^e programs. Some of these are routines to be 
UH!'i1 in the finished i)rt)!;ra.m, like the Monitor MOVE routine. Others' 
.'n this- list are general, special, or vety special screen output 
routines, and StiS^ tfata matiipul'^i^ii t^^tines. 

ADDRESS TABLE 



r 11 lie t ion 


Ilex 




I'C C 


^^o n i 1 IT 


I'^c j*ist cr s 




AGCI 1 


>\u n r 




La r)t! 1 


Dcs t r oyed 


1 lI f 1 J ■ r-m^ r 1- r"^ T A i-r-x rij-iVrtr^T^ "-L^- f^^T f'^tj 

wrLi-<- riyEif in i\ co scLOcn 'jv,ijt[» 


f [Jr. 




_> J 1 


'..w \ 




1 1 IllL I L JJ,tr I L IJE n U C r in "lA J IJ I ■ 


r IJcM. 


^AQ r ft 


ij z 




A 

,'\ 




1' ? ^ rj 


O-J 1 (3 








Print <K) brinks thru GOUT. 


FSiA 


6381!! 


-1718 


PRBL2 


A,X 


I'rfnt character in A followed by 


F9^C 


63R2(1 


-1716 


PRliL3 


A,X 


\ / 1 J <l LLIVi) ■ 














r r -lii 


□ _> J J D 






A 


I'rdir "FRtt" flnrf RFl T ^Tlt■(l TOUT 


FF2I) 


65325 


-21 1 

i 1- -L 


PRBRR 


A 


I'riRt low n^htilfe af A as hex chart 


IDE? 


64995 


-541 


PRHEX 


A 


iM'inr iv-rcg 41s t- nibbles. 






-550 


PRBYTE 


A 








-1728 


PHNTYX 


A 


F-t MIL '"(Ji?. t^^gBV 






—J- /-HfeJ, 




;& 














I'rint (.-K, Chen, hex or i,a r'^S.i 




-Mi p. 




A,Y 


Mm'n minus sign (or dash). 












I'rlrit hex of V,X regs, then lia-'Sh. 


FD99 


64921 


-615 




A, Y 

* 


I'rlnt r:K, hex of AIH.AIL, and dash. 




64914 


-622 


PRAl 


A,X,T 


I'rint memory as hex with preceeding 




64931 


-605 


XAMB 


A (V'-e) 


.ifldrenH Fron ranimm to ranm? where 












riinnri is Initial content of Allj,Il. 












I'rlnt memory as hex fron (A1L,H) 


FT)ii3 


64947 


-5R9 


XAII 


A CY=0) 


thru CA21..1-1). 












;;;n'c A,X,Y,P,S rep.K at Si5-49. 


Ff4A 


65354 


-IS 2 


SAVR 


A,X 


l)iKi>lay registers with nanes fron 


FAD 7 


64215 


-1321 


REGDSP 


A,X 


$'15-49 as SAVVId, wtrh pre,(iee(iliia 












rnrrlafte return. 












i>lHpiffy i^fts as ^bo,\*e without Cr. 


fADA 


6A218 


-1318 


RGDSPl 


A,X 


Ilusbni'e ri!^^ ^lyX,,^,? not ,S ttgm 


FF3F 


55343 


-193 


RESTORE 


A.X.Y.P 


M«rito*- {^ivmanii PreK^syc CT, encry. 




65206 


-:m 


GO 


A,X,Y,P 


^Jet PeL., H from Ji-ll.,11 if -enterfiij., S 










Cull KKSTOKR, Bel. aii regg imt 


FEB9 


65209 


-327 






Juisp -via PCi-,,!!, 




&5X13 








Hovo memory egniEgiUrs '^AilLjH,) 


TS,2C 


65368 


-4"&& 


■n6m 


A (¥=^) 



fron <A1L,1I) fehru EAtJ.,.H). 
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Funct Ion 



F953 



to. <AlWil> tli£u"3^sa^j-tj!j print 

d-lffersnce? thru .(MUt. 
Increment A4L,H ($42-43). & FCB4 

Increment A1L,H (S3C-3D), set Carry FCHA 

X£. ^h,n %.^se than AIL.H. 
Set ^S1,K. f ar line (A). 
Cle'ar ^-r% to 4 alb^i^, -itmi-M- 

in low nib"ble enti^ low nibMe if 

entry carry clear, high nibble I'f 

entry carry set. 
Disassemble the instruction at 

(PCL,H), print tlirvi COUT. 
Compute (PCL,H) + (LEMGTil), leave 

results in A,Y. Deciraa) Mode Flag 

must be clear befort? calling PCADJ 
Read paddle (X) Into (Y-reg). 
Wait .01 seconds, then sound bell. 
Load Y=!92 for .1 sec of bell, S 
Toggle speaker at I KH,Z for itmnboc 

of cycles tn Y-re^.- 
Place tava^^tfex- "iv: si^^^m teflS'eti. 

iWROiy ft" not- CMit-Eol character. 

if iHicwn cotittol C^(!i-act er , .do It. 

Xf unknown control charaeCer^ E'^'* 
windov to blank, sSt etil?»Sr 

to- tcip left corner. 
Load into Y, then print dash. 
Print dash thru COUT. 
Character print Co screen output 

routine entry - normal for CRWL. 

Print character to screen with 

appropriate actions on contrtols 

and control characters. 

If (AX5A0 goto COUTZ, bypass 
inverse video mask. 
Monitor entry on RESET is7 pressed 

or Power on. 

Call SETNORM - white on black. & 



Sound bell 

Monitor Command Processor Entry- 
Set "*" a? -pfro^ 'f^^rSfe^^t 
Set (a) as promct c'ha.pacter 

flQl^tiftSE -C^ttiiand proCHs^f tieJiamaaa. 
parfl-iiig iTSBtinef saw ^iwc .dJ-gS-rs 
1» S2l,H, *^tiit^' with /^-^.-i-s 



Hex +Dec -Dec Monitor Registers 
Addr Addr Addr Label Destroyed 



6507S -4S8 VFY 



63&96 
63927 



-S44 Sterna 

--0% HJi^TAl 



A 



-1-9J7 GBASGALC A 
-1927 A 



-1840 INSTDSP A,X,Y 
-170 PGAQJ A,X,,r 



FBIF. 


M2nf> 


-1250 


PRE AD 


A,Y 


FBDD 


64477 


-1059 




A,Y 


FBE2 


64482 


-1054 




A,Y 


FBE4- 


64484 


-l(f5Z 


BBIL2 


A,Y 




&45!i9 


-1027 


VlDQUl 


A,Y 






-93 & 


HOME 


A,,Y 




6-4124 








FD9E 


64926 


-6it 






FDF0 


65008 




CCfUTl 


?"A 



FF59 65369 -167 RESET 



f, FF65 


65381 


-155 


& FF66 


65382 


-154 


FF69 


65385 


-151 


& 

& mm 


65387 


-149 


FFA? 


65447 


-89 



GETtTOM 



{'ffrst Tion-hex) in A— r^, Y--r«g 
Set for next character. 



AIL, I! 60,61 
A2L,H 62,63 
A3L,H 64,65 



S3C, 3D 
S3E , 3F 
$A0,41 



a4l,h 

PCL,II 
ACC 



f.6,67 S^i2,43 
58,59 S3A,3B 
69 S45 



YREC 
XRF,G 



71 
70 



$47 
$46 
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LO RE S P LOTTI N 



In standard (or low resolution) plotting mode, the j;raphic area of the 
nr'rci'n is 40 points wide and either 40 points hl^h with 4 lines of 
r cKi below or 4ii lines hij^h. The X coordinate is horis^ontal and the Y 
inordinate is vertical. The same memory area is used for low 
I'csoluttoti plotting as Is used for text output to the screen. However, 
in the graphics node, each character position contains information for 
(wo j>i..t jKiintH, one immediately above the other. Thus, 20 text lines 
.lie ufiL-d to display 4M {graphics lines In the mixed mode, and 24 text 
I I lies are used to display 48 graphics lines in tiie full screen [node. 

Tliere are four bits allocated for each point, by means of which the 
pfilnt raay be dlsjiiayed in any of 16 colors. 

Tiie- Monitor contains routines supporting the fallowing functions-: 

Set display mi.de to rdxed ^apUics and text. 

Cleai: ths, gc-ajililes fiatt of CJie' streen (in vii&le aac in limlceiJ 
part). 

-%t, « ai^lm, ie^iftK^l byte to be used fpr. .jilot psint 

es^abitehed nntlll Another color le eeieiitM. 

Plot ii single point at an indicated vertl cal /horizontal position. 

Plot a hori^;ontal line from one vertical/hofizontsl point to a 
vertical value. 

Plot a vertical line item one verticaiy horizontal point to a 
vcr t i cal value . 

Return to requesting program the color value of the point at & 
spectfl-ed coordlnsCe-. 

I'hiTC are limitations on ijome of these functions which may not always 
lie desirable. For example, using the entry point which sets nixed 
HCHplilcs and text includes clearing the graphics part of the screen, 
Ht'tttna tlis Scroll Windpw to be the entire remainde,r oJ; the screen, 
mid ibotjIt^ t-ke iGucBctlr iHtu-aiglie i^v!a Eroia current poatcifjii;,^ to the 

iralnfr fet s&t-titi^ feul'I iftGl-fien gta^fclfis -njede. fis»^wieJ;,, the ^s^g^ mode 
i-Mt If ol ^' fff^- ^^If 4et in atty ■^■fise^ Sa^^i^ ifig*#^' hf f!>kl.tiEs: 0r 
Hl.jl-lrvg tuto, tiie aopropriate amoi-'f l&e*itiinja, «o t-his Is' ti'ej?6«iill^ ijii 
mil )nr firobleni. 

VnriouR pfls& ^ero locations are used for low resolivtlpn grapliics mode. 
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PAGE ZERO FIELDS 



Routine Addr . MM , SieSerijtfei-a.n 

GBASL.R 38-39 S2fi-27 Is eet &y the gB^^;^ pS, ttie menoTy 

adttress Wie jil^itt-ii^ line' spaeified. 



COLOR 



MASK 



46 52^: 

44 $2C 

45 S2D 



eontalns t^ie sel^ct&il col&ir v*l«e lit both high 
and low TilM)l«S 6£ the 

is UKSd internally by Che plot routlTies as SFfl 
or to set either the hl^h or low nibble of 

the reeeivinf, byte (iependins on whether the 
graphics line is Che top or bottom of the two 
displayed frbm that "text" like. 

is the right end point fat horizontal line 
drawing. 

is the bottom end point fo£ Vertical line 
drawing . 



I- pn 




ADDRESS TABLE 



Fuiict ion 



Plot 3 point fit line (A) c-.ol . (V) 
leaving CllAi^L.II and tlASK set. 

Plot a point, line per GBAHL,H 
and MASK, eol. in Y, 

Draw horizontal line at (A) from 

(Y) thru (HZ), left to rij^ht. 

Draw horizontal lino at linp 

indicated by GRAKL.H. MASK f roo 

CY) thru (H2). 

Plat vertical line at (V) from 

(A) thm (V2), 

Plot vertical line at (V) from 

^iai vertieal $1ne SfC ttj. frtffii 

^Je^r f.uil '(tS ixheS'S- scMen. 
mjESx graphics area ifi,^ ll-(lfes3,.. 
^lear graphics partial reoHi "ifnte ^ 
tft^ CS), 4(5 col. wide. 
Clear graphics partial ffom lih(^ 

to (V?) 43 col . wide. 
Clear graphics partial, top left 
Jints !? thru (V2)„cq1, thru iri), 
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Addr 


Ada¥' 


Addr 


Hon! tar 
Label 


Se^^i; 
DeSt 




63488 


-2048 


I'i-OT 


A 




63502 


-2034 


PLOTl 


A 




63513 


-2023 






F8IG 


63516 


-2023 


HLimii 


A,Y 


F82 8 


63528 


-2008 


VLlNi; 


.A 


F826 


635Z6 


-2010 




A 




63533 


-2«03 




A 


"sm 

F*3'8 


&i538 
&3S42 
'63:54* 






A.Y 

A,t^ 


Fa3A 


63546 






A.Y 


F83C 


63548 


-1998 


CL[I,3C3 


A,Y 



Funet Ion 



S. t I.OKF.R screen tO COLOR from top 

left corner to (Y>,(V2>. 

KnCry A-rep, must he 0. 

F.n t ry Y-reg = rij;ht (Column to set. 

Set V2 to last line to set. 
■^I'L COLOR for following points 

to (A). 
Cli:irii;c COLOR to (C0L0R)+3. 
I,o,-Ki to A color of point (A),(Y). 
Si'L CBASL.H from A. (A)=line/2. 
Si;t Color Graphics display mode 

and following are also done,; 
Si'L (graphics mode to Mixed. S 
Cluar firaphiCB part of screen. & 
Ujfld S14 to, A for WNEIOP. (, 
Store A Ecj 'SSSIKKS'* i. 
L.iml 3 to A f(jT WSDLFT. S 
S[u!;e A to WKDLFT. S 
Ijwid :S'28 to A for IJHBWMH. & 
Stnre A to UHBWD.'TH, S 
hiirtd gig ft), A fjjr WNDBTM. £ 
Stoc.e A to; MBBtTK-. S' 

[.Vnd to -A. Pfet 'CV. & 
T;n *o tA-W CO set BASL.H. 











Addr 


Addr 


■Add* taJiei 




E840 


63552 


-1984 


A,Y 


Ffl64 


63588 


-1968 SETCOL 


A 


FR5F 


63583 


-1953 PIXTCOL 


A 


F871 


63601 


-1935 SCRN 


A 


F847 


63559 


-1977 GBASCALC A 


FB40 


64320 


-1216 SETGR 


A,Y 


FB43 


64323 


-1213 


A,Y 


FB46 


64326 


-1210 


A,Y 


FB49 


64329 


-12*f7 


A 




6»331 


-XW% setWnd 


A 


■FB4T) 


54133 




A 


FB4P 


6433.5 


■^tmi 


A 


f&51 


B433? 




A 




64319 


-1.1^ 


A 


FB55 


64341 


A 


FB57 


6i343 


-t'\m 


A 


FB-59 


64345 


-1191 


A 



DATA MANUPILATION FUNCTIONS 



:iy .1 naniber of routines in the Monitor which may be called by 
injrr.ims to perform often needed tasks. The rootines described in 
nre niisr.cllancous routines which move data from place to 



t i on 

|i 1 ' o I' i'i>iiu*?r t tho fo rm <>f info rmati ori provided to the routines. 
Mill !■ Uint some of these routines are In both the Old Monitor and the 
Aul«rtL/irt Monitor iil),ll« uther routines are in only one or the other. 
'I'liriT nddrefi!! tables ate provided; one for both Ifonltors, one for the 
(ilil Hrjriltor, and one for the Antoata-rt Monltoc. 



ROUTINES 

Memory to Memory Move 



I'IiIn mill \\Mf Is HHcd hy the Monitor "M" command. As the Command 
I II ( 1-1 |)i <■! Mi-ung the keyboard input, fields Al, A2, and A4 are 
I'"||1<'||. Wbi ii the Command Interjtet*?i: enc^^nters the. "'M" it calls lafeel 
'HiV[., ,i.'i linlh-nE«d in. the- Ea-tile-. The cjeniEeilts. of m^iory fron locations 
(Al) ilirii CA2^ nre moved ^^■^^ ^^liftjrig .^m. ItSi^t^oVi (MJ. See the 
Mii'tfiijlr iiroBnim in the section "Secxwaisy Sisjii^y A«ea Bays and Means" 
f.;r UH.' of HOW- EtyiTi BASI?:, ^th. EBte .^i^Htance ,of the ^ton^tor GO 
roiiiliii- for HptciitiR regl^ieW ein fcfte 'i^y-'" in. 



Jump to Address with Registers Loaded 

The routine in thy ItoniCor which responda to the "G" cocnmanfi iiaps gome 
Monitor routines from BASIC or APPLESOFT in that the registers are 
loaded frora the save area and then control Is tra.naferrQd Co the 
location specified in PCX,[[. Thus, a BASIC program can set up th<? 
destijijtian address and register contents, and then CALl, to have 

the requesti?d routine entered. This Is used in saepl e programe in this 
aec'tlon and tn the sectiotl on "Secondary Display Areas", 

Increment Address Fields 

The floiiitor Hove routine described ahave is a sample caller of the 
NXTAi nnd ^^XTA1 routines. Iflien NXTfl4 is called, it Increments the two 
byte field AiiL,H and then falls into label NXTAl. The Covitlne at NXTAl 
increments the two byto field at A1L,H, and then compares that field 
to the two hyte field A2L,H before returning to the calling program. 
On return to Che calling program, Che Carry statBS'. bit Is clear if 
(AIL.H) is less than or equal to (A2L,H). Carry is set If (A1L,H) is 
greater than fA2I.,H). 

Save 6502 Registers 

The SAVE routine is used by various other Monitor routines to store 
Chu 654f? registers in pege zero locations S4j-S^^- This routine raay 
be chilled by user program under eertain conditions - namely, that 
neither the Monitor nor any other program will be calling SAVE- at tfie 
same time. In the Old Monitor SAVE and RESTORE are used in support of 
Monitor commands S and T, single step and Instruction trace. In both 
Honicors, the SAVE routine Is called oa a BRK Interrupt at entry point 
^atl 'OS tKe &--re^g is Stored at §45 on entry into IRQ liiterj-upC 
piTocessfng* 

Restore 6502 Registers 

The routine at label RESTORE ic the inverse of the SAVE routine, 
expapt that the S-reg is not loaded. In the Old Monitor, RESTORE Is 
K.ti%izcd by Instruction step,- a&d t^^Sce CBtttit^^ l3e:gi3't,e. 'COftE ^^13«d 
■exeKUf.l.Hn 0,1 ea,pl( iTlstMCi;I«n* Txi Iwth" .fioJlitoFffj tW, regiat-era 

transferring control to- the eperator— indicated location. 

Multiply Two Byte Fields 

The W.n, and MlJLPfl roi]tines multiply two byte fields to givf a iour 
byte product. They exist only In the Old Monitor. If a program (silch 
as an assembler) calls nULPM at FB60, and it is executed with the 
Autostart Monitor in the machine, the r^s.ulC is that an .each Gjill Ete 
screen vill be cleared snd. "Aff?m II" '.All H 'mi'txect m. the tsy line. 
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Multiply Routine 



Sfet ftjrttplier' 4ft S55,54 (MSB,LSE) 

^ Set Miilti^lie«n4 lit S51,50 <MSJ,I^B) 

Call/JSH FB6!J i>t FBM (-1184 or -1181) (MULPM or MUL) depending 
alKO conventions or reiquireneiit*. 



I 1,1 the follcMins that the dS*a fiel-^g tat cail'ttplj' aad divide -are^ 

1^ rjfl ^" '^'"^ same format as other wj.tiple .bj-te nurafaBtra In the ^pje: lowest 

1 ' ~ neaory .address Is least slg-nlflcant byte. 

. pa 

^ j^JU The result, In order of most significant to least, is In §53, •152, 

j S'ii, S5i*, this result Is positive. If one of the t^ro input factors 
_ 1^ not both) was negative, then SIGN (at $2F) contains an S01 bit, 

r I Mi Indicating that the result should be complemented by the user proeranl 

I before further use. 

t l3D '■"'''^ ^" ari|te. (SF -S&i^ with ■?■ hfts- long -entri-es, tl)e address of 

tntry ,8- can. be .(t^«J*ji"rtad liy entering the multiply with 58430 in 

^ 1^ S53,%2 BTid thS'-8 and 7 in positJon for the multiply. 



'4 



NOTi-,: Tlie table of values above Indicates that $53,52 should be set 
lo ^A-ru before calling multiply. If this is aat done, then the initial 
oiiteiits of this field will be, add?,-* .to the tftSttl-tj. Eot «*ara|sle. If a 



Rxfimples.; 



RQUt4ne 



^ M ■■ 






.$53 352 


$51 


$50 


SZF 


m n 


m 


01 


00 0^ 


W 


31 




m 01 


01 


00 


00 00 


01 


00 


00 


04 00 


0S 


00 


00 20 


00 


00 


00 


FO 00 


08 


00 


00 20 


00 


00 


01 


FC 00 


F8 


00 


(10 20 


00 


00 


02 


7F FF 


7f 


FF 


3F FF 


00 




00 


80 00 


02 


00 


01 00 


00 


00 


01 


80 00 


80 


(*0 


40 00 


00 


00 


02 


W 01 


00 


di 


m m 


00 


01 




00 01 


01 


m 


00 00 


01 


1<i 




04 03 


08 


00 


00 20 


00 


m 




FC 00 


08 


00 


07 E0 


00 


00 




FC 00 


F8 


00 


F4 ?0 


00 


% 




00 FC 


00 


Eft 




PA- 






.80, m 


02 






n. 


0(S 






M 






m 


m- 




12 34 


56 


78 


06 26 


m 


60 
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Divide Four Byte Dividend by Two Byte Divi3or 

This routine .dtvii^Bs 'a fimir liy'te iHvldeiid "by a two bit ilitVisor, gfvfftg' 
a two byte quotient anij a two byte remainder. It is available onJ y in 
the Old Monitor. This routine accomplishes the division o£ the nunber 
tn bytes §53, 52, 51, §g Jjy tte flUf.'^T In bytes 355, 54, leaulng th^ 
quotient In S51,5(S ^oA- ttve T-emaiftdflf in 553,52 (most significant t6 
least significant). 

If the contents of .^.53,52 is larger than Che. coiirents of 555,54, then 
the result will not fit in the quotient bytes - overflow is the 
tesult. The calling proaMia raust not let this happen. 

With regards to scaling, looking at the four byte dividend as an 
integer value and the divisor In $55,54 aK an integef, Che quotient 
and remainder fie'ldB are alsi* Integers. 

Sign can he a problem ft Che DIVPH entry point is used. The sif,n hit 
(if the dividend le the $80 bit of byce $51. "I£ the intended divide is 
two t^.es fS*li6h SI3,.|a (ije^tiefl itefore divide) then signed fields 
dlyi^t^n- is- s;^9r.ted,, witii. fefte' sign. bei.n^ t.tie ;.SB qf §,2f. If the 
cal.l Is. to,"O^I^', •ftia 'lit. $2? cofiE^lsa ,§01^ t^a- cowXew^t the ES^lfcS 

Utea using unsigned divide, erlta:if P>X'yX • tlien tha divide la 32 bit 
rmu by J6 bit field with 16 tiit -ir«snitB- 

Exainpi.ea! 

Galled ISlptttS Outputs 

Kc.uti.»§ .@tyidiend Divisor quo^E■lent Bemainder 3lgn 





Sbi V2 bl bfl 


:S5!> !i4 


S!.l 


30 ■ 








DIVfM 


m ;o 00 013 


08 90 


08 


90 


00 


00 


w 


[SFB81 1 


00 m m 38 


09 94 


00 


92 


00 


00 


00 


[6438^1 


00 01 W 00 


00 (yi 


80 


0fJ 


00 


00 


00 


[-1151] 


90 00 00 03 


m 02 


00 


91 


00 


01 


00 


00 0(3 .30 00 


02 m 


00 


18 


00 


00 


00 




00 00 30 00 


20 90 


00 


01 


10 


00 


00 




00 00 33 33 


00 22 


91 


Rl 


00 


11 


00 




00 10 40 00 


04 m 


04 


10 


00 


00 


00 




00 80 00 


38 0$ 


04 


10 






^1 




00 


9S 


4h 


# 


'm 




rr 




00 10 41 00 


0? 90 


04 




01 


90 


W 



DIV 

[SPB841 90 80 0^3 'M !10 00 01 0(S M 00 

[643B31 00 09 M 00 08 y0 00 13 00 00 

[-11 48] 
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Esfablist^ a RESET Vector 



Th,g'Aotosl:art Monitur supports an address vector for c.osipletion of 
handling a RESET Interrupt. It is called the Soft EnCry vector as it 
13 designed to allow resumption of proceEsing after a ElESfiT. This 
vector is in page tliree. It contains the aiddress to iJiich control is 
t.O he transferred after the screen, kcyhoarrl , and other basic Apple 
b.'irflware itens have been set to their "initial" states. For example, 
the display hardware is set to display primary area f.ext , and the 
Scroll Window full .screen values are set, 

AfU'r fliicb iiiitiall^;atton is performed, locations S0'5S aftd are 
li'Htfd ap.alnsE one another to rietermine whether the vector in $03F2- 
^Mlin Is to be considered valid. If so. control is transferred to 
($;f1F?-^13F3). Normally, this reguica In transfer of contral to §£^03 
M. ;i,-romplish -tfee re?liJt eJi(a:y -fia 'tt# BpaSfBr' of a 'fSBitr^l-?:, fe- 
i-iii ry into .B&SI^ %P|4§&fa;, Buj-lHg CW te0t#t.i^% ogetatlon, DOE 
iriKi,ill3' iptf, tmtmx 'lli this -v^icKbr. '&aA, bf 'e^rse, you 

wish to set SQWS- (StteS valus in this vector, such as that v*lc!, will 
cause the ifonitor EifltH .asterisk pronpt) to be called, as was the 
normal case with the Old Monitor. To Set a different value in that 
vector. H>K£ or store the desired value in $03F2-S03f3 and then CAIJ, 
or JSH Eo SETPWaC C^KBfeE or -1169) to have the Monitor set S03F4 
nt't^riiprlatel-?; 



Convert Hex Gticu-acters^ io Valtie im Use 

Proj^rammer utility -pE.og,raiB8, olfceii need input of addrees .or -data fn "hex 
r/ither t\\^M. iv, (iei^iioaj*;' ma&tta^ also uses input In hex, and' 

thpreToice ftaa -my of converting input hex characters to a valno in a 
Field,, Tfte GE'imiti routine in the Monitor converts characters from the 
ke^bQarrl Inpnt area (S0200-S02FF) Co heK stpred in A3L,H and 
C(inrfis.lnnally Xn All,H and A31.,H. 

Thp ftKTMTirt' routine cocverts characters in the S0200 area beginning at 
50?00+(y-r.fi, ) and fonCinuinR until a character ir, founri wliich is not a 
h.>x ilij'li (not. (J-'J or ^-F). The result in A2L,H (and A11,H and A3L,n 
II (PlolilO CJ) iH Clio last four hex digits in the strixTg r.onvfjrccd if 
'hi' 'Mrliiy, is mori.' tlian four hex digits. Tf the string i:; fewer than 

' hi'M iili'lm ih(> rcSoTilt field contains the value right adjusted 

vjIiIi lividlug vetoes. A saiiiple program Is provided at the end of this 
K.irtlod nhnwin;; use- of GEBIIW from APftKSflFT. 

Disassemble an Instruction 

The Apiilc II Monitor contains a disassMiji>ler by means of which one can 
.ll.'.pl.'iy ji ;.iirlloii of a i.iachine lanBua,'^e progtraci In nnemonics instead 
<'l lust lirx. At label LIHT (<;Ft:5F.> is the routine to which control is 
|"iHHi.-d wticn chf ftanitor c^ramand "L" is used. Thl^ routine sets a 
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ti4eS». iJi-tfi kpptopfjSE^t'e ■3*J'a«*!*ft*' t-he 4^"m?:tion. pointer PCL.H. 
Thli roatine, eftrt fee .i^^ft. as ^BJ 'fesiai^lfl ■ tia^" CS)"^ tise the locati-ons in 



^i^t.lpe ae isStpSP uses the INSBgl" routine to set the zero page 
kiSijatjii'ti*, Fffl8*tat ana LENGTH appropriately for the instruction at 
(PCL.H). INSDSI also prints to the screen the contents of PCL.H, the 
address of tile Instruction to be disassembled. On return from INSDSl, 
the INSTDSP routine controls the printing Of the rest of cbe 
disassembly II ne. 

Note that PCI,,H is not altered by di Ka.iKombly of the Instruction. 
Thus, it must be "malntalTiecl" by Che program which calls IMSTDSPi 
This Is aceomplisliRd by calling the PCADJ routine, which returns Che 
new values to the calling program, to store into PCL and PCli in the 
A-reg and Y-reg, respectively, having computed the new value from PCL 
and PCH ana LENGTH ("set hy INSDSl). 



ADDRESS TABLE 



Hex +DeC -Eee ^fonlt^r Eeslsters 
Addr Addr Addi- Label DeStrojed 



t 

t 
t 

t 
t 
ft 
t 

E 
ft 

t 
t 
f 
t 
ft: 



Multi^iy signed fields leaving 
sfgm LSB of SIGN. 

Ifeltlpl^ tislSs liosi^a, 
(51,53:) * (55,54^= (5S.52,5I,S"0), 



FE60 64352 -1184 MDLPfl 
FB'S3 UtS5 -iV&l M. 



Divide signed fields leaving algn 64385 -1151 DIVPM 

in SIGN LSB (from 51,55). 



Divide unsigned fields 
C53,52>5I,50)/C5&.^'l)-(51,5a). 

Set abhalute values for Ai."h,l[ and 
AUXl.fl leaving reauiting sign in 
LSB of SIGN (called by mm and 
DIVPM) . 



-1148 hIV 



FBA.4 bWlf -1116 irai 



A,S,Y 



ADTOSTART MONITOR ONLY 

Set validity of RESET vector. 



FB6F 64367 -1 I6y SETPWHC A 



BOTH GiiB" m>- j^^TftSr fmnmti 

[fonltoT G"«a&tiHfl lRc»G«ss6x .so; fcDtjry,, 
Sflt Fct.H (torn. AIL^H 'iS '^r^Vx^d^ & 
Call RESTORE, set all regs hut S.i FEfi9 
Jump via PCL.H. FeSC 



^Mf GO 



6525(9 -iii 
65212 -324 



fc 

t 

t. 
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F.unci.i,Qn 



Ren +Dec. -Dec flonitor Rej^isters 

Addr Addr Addr Ijjjjol Destroyed 



Move b7tes in memory to (A4L,H) 
rr™ (A1L,H) ttiru {A2L,I1)- 
.N'ote: V-reR must be ^ero on entry. 

IniTf^ent pointer AALJL £ 
Im-rcmont jiointer A1L,H with set 

of carry it resulting; (A1L,H) is 

RfeaCer than (AZL.H). 

S^/ivG (,592 reRs A.K.T.P.S at 
545-549. 

Kestote 5503 cegs A,X,Y,,P from 
S45-S48. 

fjMlvert hex characters from 
S2M,r tw valu^ in A2I-,8 <>^a 
Mh.-Ef and MLifl ±f 



nlsasBeinble one instruction, with 
(llBplay thru eo0T,. 



i;ipii!liMto new PCL, II after disassembly F953 
IT trace or step - return results 
m A,Y rega for (PCL.H). 



FK2C 65H68 -468 MOVE 



FC114 64692 -844 NXTAi A 
FCSA 64698 -S3fi tJXTAl A 



«5S54 -182 ;SA^ 
mv 65343 -193 RESTORE A,X,Y,P 

'$54"4T GETHUM A,X,Y 



^3696 -1843 INSTDSP A,X,Y 



63827 -1709 PGABJ A.X.Y 



APPLESOFT SAMPLE DATA MANIPULATION PROGRAM 



"life 



If Rm 

•I It 

'•If t;oTO Itfflg: 
■JM REH 

3lir POKE 5S^167,! 

2^1* pnKE 59,255.^ 

.^■10 SJI? » An^ + "■! 

24« KfiK' 1 - i f am 

253 C:c;S^ - MTDS (SIS. 1,1") 

2f-0 f;d - A!:c Ccc$) + lis 

27(3 yam ''12 + i,cc% 

i90: pOKK II, u ami 

■m' PORK 49, REM 

11'^ CfiLL - '327: REM 

KT - Im;i;K (62J + 256 * 

iia IF ST > 32767 aratJ ST = 



DATA MANIPULATION FUNCTIONS 

S,\MPLE PROGR^f 
MKMOftY DUMP 
OF IIi';X AREA INDICATED. 

RFM BYPASS, SUBROUTINES 
CALL (3;TmJH ROTO^? m ■© RSIffilSE^ 

BUILD StRIHG TO KTQRE 

RQl! STORE STRiH& IN IKPUT BIJFFER 



3F,T YRRG TO START AT LOCATION 5l3 

CLEAR MODF. BYTE 
G) I'ROCESSOR 

PEEK (63): REM ST=START AWDRES S ( SA2 ) 
ST - 65536 REM TWO'S COMPI.RHFNT 
ADDRESS IF >= 
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600 


REM DISPLAY HEX COMTKNTS 




610 


Sll% = ST / 256 R??1 GET HI lUlDRKSS BYTR 




620 


SL% = ST - SH% * 256: REM CRT LO MIDRKSS BYTE 




630 


IF fiH% < THEN SII7o + 256: REM CKT 2'S COflP IF NF.CESSARY 




Rm7 = si 7 - ( INT (SL% / 8 )) * B HEM RtlX = MOD ? 




659 


; OF LO BYTE 


mis 


TF RMZ THEN CALL -622 






POKE 71,0: REM SET "Y" RgG TO ZERO 






POKE 58,163: REM PCL «• Sli3' 




69.0 


POm; S^-.253! REM PCH ' SFD 




im 


CABX, — ,3ZJ: 5®I CLEAR "Y" REG £. SFDA3G 






POKE 36,l9[' PRINT "I "; : RSI -SEPARATES HEX yupH 


ASCII 


720 


REM DISPLAY ASCII CHlSftf^ER CONTEtfTS 




730 


SE = ST 4 7 - RM% REM SEPAEAKS HEX mSf& ii^H 




7A0 


FOR I = ST TO SE REM PRINT ASCII OWT^S 




750 


CX = PKEK (1): IF CX < 128 THEN CX - CX -f 128 




760 


CXS = CHRS (CX); IF CX < 160 THEN CXS " "?" 




770 


PRINT CX$; 




780 


NEXT 




750 


RF.TIIRN 




1000 


REM PROGRAM START 




1010 


1 [\ 1 1\ j_ 1 L A 1' J. L J ■ 1 




1 020 


T MUl ['1' "FMTKP AliriPF'^S "'Af)'! 
1. r U 1 EpIN J rji\ rt ljuivEj ■ 1 t v 




1030 


TF AD(; = "Fnn" THFN END 




10^0 


IF LEN (AD$) = THEN 1100:REH CONTINUK WITH NEXT 

ADnRESS 


AVAIIABLE 


1050' 






10fti) 


;1«-J. TO 16: REM PRINT Ifi LINES 




m% 


mm& 60SI 




\m 


feai - ST + 8 - UM7,, 
















1130 


06T0 1020' 





MONITOR COMMAND PRI>CESSOR 

The Monlcot: Command Processor 1b that part of Che Monitor Atcli 
responds to comfflands entered with the "*" prompt fetoaj-,actfe)f' aese 
comra.-iTids incliidi^ data Qovement from one location -to anot-TiEt,, OSssetCe 
tape reading ond writing, instruction- 4l5Sase»'Iii.j?» (itfl'e?^ 
described in Che Reference Ilaniial. The fefetrenee tenual corifalris a 
complete description of use of these comnands . This section of this 
manual describes calling some of the routines from a user program 
Instead of from the keyboard, and ^plTig Into Che Monitor with m 
return to the user program. 



ENTERING THE MONITOR COMMAND P!^0<^SSC^ 

The Monitor Command Processor is that part of the JSpl-Stor which reads 
keyboard input wth the asterisk prompt character and performs the 
requested service. "EnterloR" the Connand Processor implies turning 
over control of the machine to the Monitor Mode. i.Jhen the RESET key la 
pj-eesed With th« Old Mo.nltar In the ApTile the computer Is placed In 
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Monitor ^^>de. When the RESET key is pressed with the Autostart Monitor 
ill the rnachine, the computer generally goes into BASIC or APPLESOFT. 
Ultli the Autostart Monitor the only way to s^t into Monitor Mode is to 
CALI one of these entry points (generally CALL - 151). 

In Lhls mode, data may be moved in memory using the Monitor Move 
iiimraand. Blocks can be read from tape via the cassette tape data 
transfer commands - Or any of the other Moni tor commands may be used . 
However, having entered Monitor Mode, the Monitor Command Processor Is 
reading the commands from the keyboard and Chen acting upon chem. 

I'Mere are a number of enCry poinCs indicaCed in Che address table for 
"enteritis'" ttefe 'HonSti**: ^Butfai-R^ Ft.6^,e8c^v yiea^e tteit;* th^t tfte 
Monitor is jumpeil Eft at \!m «peerl.Cl'e^ |)olftfe». *ll of the inltlallz^cloa 
described after Ctia:t CSft^y IJQ'l^- t*i ,#lsO -pfiicf&^lseii- This- la Implied by 
the "6" at the end of each function description. 

OALLIN© THE MONITOR COMMAND PROCESSOR 

"(lalling" the Monitor Cofflinitlld Processor implies that return will Cake 
place to Che calling program. However, the driver part of the Monitor 
Command I'rocessor Is not designed to operate in that fashion, so a 
Mborc machine language program Is required to allow exit back to Che 
culling program. A sample program Is provided at the eti4 o£ thIS' 
Be.cCion ImJicating the .required aet.jip. In the .s.^TOfile, '^i^ '^^if^. b^^fcei 
tMichiBe ia:ng,uagfi- rwrttn^- is 'p.^a.^i pag« two (at It ma;!- 

flHCed aitywhefe d^s3j:6d., 191!^' this program., Hofiitor calls, fronl 
UASIC oc APPLESOFT are 'tmt^ Eapportad . 

A program which ^lAiis tte iTommaod PtaG«asQr must fir&t -stfife, tfee- three 
h^'ie exit routine ^prafiirfi^.e;. i.tKe cRjr.ogT^ao -^sm ?SKB' a i^trdfie of 

Monitor commands Into the ItipUt begltmlTl'g at" address the 

li'iiii command of each such string being a Monitor CO command Co 

I i.Mi!: lor control to the exit routine. In the sample, the last Monitor 
iiiiiiin:iiid In Che string is "02FCG". Ttie function of the exit routine Is 

lo i'mI 1 one return address level (two bytes) off of the stack, and 
I lii'i do ,m RTS to reCurrt- to the BASJC, APPLESOFT, or machine language 
I'll I I i ng program. 

ADDRESS TABLE 



Fiinrt Ion 



riiiiihiii' roiiiinand Processor, "blank" 

(Tii I V pdliii usod for CR. 
rinu h i.r ri.miiuind Processor , "blank" 

I ■ I iiiiiii/fnd *'ii I ry pni nt . 
Nruillor (^iminand Processor, Store 

I'oii r ! Ill' 4 

Miiiillor Command Processor, set 
MOIII: for colon, period, plus, or 
ml iiua . 



Hex "^SeP -Dec Monitor Registers 
fl.S'dr Addr Addr Label Destroyed 



FE00 


65024 


-512 


BLl 


A,X,Y 


FE04 


6502S 


-508 


BLANK 


A,X,Y 


FE0B 


65035 


-501 


STOR 


A 


FE18 


65048 


-488 


SETMODE 


A,Y 



function 



Store appropriate value to MODF,, 
entered from BLANK also. 

Monitor Conc^aiid Processoi" routine 
for less than (<) c.ommarLdy 

Monitor Comiand I'roceKsor HOVE 
routine. (AlL.H) thru <A27,,H> is 
moved to {A4L,H) thru whatever. 

fionitnr Command Processor VERIFY 
routine. (AlL,h") thru (A2L,H) Is 
compared to (A4L,Ii) thru whatever 
with differences printed thru COUT 

Monitor Command Processor LIST 
£^l6;=i^§,^l)ler3 routine; list 2(J 
iuBt ructions thru- CODT. 

Set ipfta--t*> Am = t^fwesse 
Set imsm t^ .pt s noimal. vSdedi. 
set lOTFLp ttiia. r-reg. 
Set port ^ {Rgy'tearil^ fnr ttipdt. 
Set port (A) for Input, 
Set port (A2L) for input. 
Set port <3 (screen) for output. 
Set port (A) for ouLpnt. 
Set port (A2L) for output. 
Monitor Command Processor GO entry. 

Set PC1.,H from A1L,H if entered, f, 

Call RESTORE, set all regs but S.& 

Jump via PCL.Il, 
Monitor Command Processor Display 

Rei;isccr contents . 
Monitor Command Processor Carriage 

Return entry. 
RlrsCi simvilate entry of blank. 
Then Pop 2 from stack, and goto 
Monitor Command Ptoc^sSiSpr JRISZ 
Restore registers from i^^4^i 

Load STATUS and push tij' atauk. 

Load A from. ACC. S 

%oad t fTom "V*Se. & 
Load P from stack tPtPJ smd RJS, 
Save 65U2 regs at $45-^19. 

Save A-reg at ACC & 

Save X-reg at XREG $46. f, 

Save Y-tcp. at YREC $47. f. 

Save P-reg at STATUS §48, £ 

Save K-reg at SPNT 549, & 

Clear 6i>(J2 decimal mode (set hex). 



Hex 


-hDec 




Monitor Ref;isCers 


Addr 


Addr 


Addr 


Label 


Destroyed 


FEID 




-4 S3 


SETMDZ 


none 


FE20 


b5956 


-4 80 


LT 


A,X 


FE2G 


65068 


-468 




A ^ 1 - V J 


FEB 6 






VFY 


A (yHSJ 


. 

FE5E 


65118 


-418 


LIST 




mm 








Y 












65158 






none 




65161 


-37 S 




aVx.y 


FE8B 


65163 


-373 


INPORT 


A,X,Y 


FE8D 


1)5165 


-371 


IrJi'Ki 


A,X,Y 


FE93 


6 "j 1 71 


-365 


KKTVID 


A.X,Y 


FE95 


6^1 73 


-363 


flUTPORT 


A,X,Y 


FE97 


65175 


-36; 


OUTfRT 


A,X,Y 


FEB 6 


65206 


-330 


GO 


A,X,Y,P 


FEB9 


65209 


-327 






FFBC 


6.5212 


-324 






FEBF 


65215 


-321 


RKCZ 




FEE 6 


65270 


-26,6 


CRMON 




» 

FF3F 


^3343, 


-193 


RESTORE 




■ 
















RESTRl 




FF46 










mm 




-184 






pfriA 


6'^3S4 


-182 


SAVE 





FF4C 
FF4E 
FF50 
FF54 



65356 
65358 
65360 
65364 



-180 SAVl 
-178 
-176 
-172 
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Function 



or Power on. 

Call SETMORM - white on black. 

Call IHIT - TeKt + full scroll. 

Call SETVIO - screen as outyjuC . 

Call SKTKRK - keyboart,' = input, 
CIc'.n- 6 502 decimal raoife (set hex] 
Eif^uiid ha 1 ] . 

McjiilLor Command Processor Entry. 
Set as ■prfytspt teSflT-.«iGJ;tif. 

Set (A) as prompt character* 
Call C.F.TLKZ to read comia^ line. 
Clear MODE before scarni-lfig Ittifei 
Pick up one command: 
Call GKTNUM to scan input Um,. 
sa-wtng hex digits in A2L,H, jjrad 
returning wltli noB-heai, in A-reg. 
Saye Y at tSAV - current place in 
^Omnand line. 
Gull roullue Indicated by non-hes 

rotti*-n«d fty, getnum. 
On return from Monitor Command 
Service routine, reload Y from 
YSAV and goto NXTITM to process 
next command in Che line, if any. 
MoiiJlor Command Processor coraiiiand 
liJitFiJtip, routine; save hex digits 
111 A2I.,H, return with command 
(I I i.'.i: non-hex) in A-re.g , "X— reg 
lii'l tor next character. 
i:.ill rnutlne indicated by conpand 
cliJirJicter : 
PuhIi address $I3£st5L. «i«t-S -^^"k-i 
Hbbh (MODF.) to caiied .Coutlne in 

ft-reg. 
Cleat mm bfiEore call. 
qSll seleiitiia fouclae by RTS. 
CJeBi- M06E byte betBeen commands. 

OLD MQmTQK ONLY 
FxPi'dtc Inatnictlon at (.PCL,H), 
with ilinplay of inatruGtloti and 

ri-ini 1 I ret', ' sCers . 
MiMilior Cimnuiiul Processor TRACE 

hull rur t Ions routine . 
iloiillor STEP one Inatructlon. 







+Dt!C 


—Dec 




Addr 


Addr 


Addr 


1 


FF59 


65369 


-167 


£ 










FF5C 


65372 


-164 




FF5F 


6J3 75 


-161 


S 


FF62 


65378 


-158 


& 


FF65 


65381 


-155 


s. 


rF66 


65382 


-154 




FF69 


65385 


-151 


& 








& 


PF6B 


65387 


-149 


& 


FF6D 


65389 


-147 


S. 1E7» 




-tH4 




71-75, 







FFe2 

FF85 



65410 -126 
65413 -123 



FFA7 65447 -89 



EFBB 65470 -66 



FEG? 65479 -57 



Lahfll DestroyeiJ 



BESET 



MON 
MOflZ 

-BKTITH 



GETHUM 



TOSTO 



mem 



FA43 64067 -1469 STEP 

EEC2 65218 -il8 ISACa 
FEC4 6522(3 -316 STEPZ 



A II. ,11 
A^l.,11 
A H,,M 
A'il.,11 
VSAV 



(.0,61 
62,63 
6A , 6 5 
66,67 
52 



S3C,3D 
a3E,3F 
340, /,1 
542,43 
534 



PCL.I! 58, 

ACC 69 

XREG 79 

YREG 71 



39 S3A,3B 
S45 
S46 
$47 
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APPLESOFT SAMPLE PROGRAM 



I REK nONITOR COMMAWn PROCESSOR SAMPLE PROGRAM 

10 AAS = "2r£;:68 68 60 N 2FCG ": REM SET OP RETURN ROUTINE P2FC 

II GQSVB. l9Mt SSi Mp,VE CraiMAND TO KEYBOARD INPUT AREA 

100 Rm RF.TITRN IS SET. NOW CALL 

1(31 REM SOME MONITOR COMMANDS. 

110 AAS ^ "F800L 1(10. IFF 2FCG " 

129 CALL - 936: REM CLEAR THE SCREEN 

na GOSUB 1000: REM no BISASSEMSIiY, MEMORY DISKUty, EEIiflt^ 

140 PRIHT : PRINT £ 

141 PRINT "THATS' ALL. " 
150 END 

1000 B - 511: RH1 POS LOtJP IS I TO LIM, SO B-^H"E BBFORE $233 

1995 JJ& " UN (AAS) 
ISfLU EOiV I - I' TO LIM 

im n * tm (MS. 1,1) 

1050 P - ASC (PS) + 128 

1070 POKE B + I,P 

1 380 NEXT 

1085 CALL - J'i4 

1090 RfilWRy 

SPEAKER USE THROUGH THE MONITOR 

There are many ways to use the speaker in Lhii Ajiple II. One of these 
Ways Is to signal program events. The Monitor contains a routine which 
sjlppbrts tbls use by toggling the speaker at 1 khz for .1 second. This 
la the "beep" heard when the RESET Itey is ijjreBsed or at fcmpletlon a 
tape record read cr write. 

The Apple TI does rmt ,Q»ntain tlie only sceaber in town. That ,siSti#' 
pTlntetft ij&'iai ^atSach 'fd &m i^plg II maice a isound of some type' when 
.prjGs^S^ ,«it^ the BELL code. On the Apple 71 keyboard this is the 

Corier6i-6, The character code la $87 or decimal 135. "Printing" this 
character through COUT wtlX ^aose ttt© Apple to beep, and will cause, a 
printer "bell" to sound If tliere is one.' 

There are two ways for a user program to call the routine in the 
Monitor »Silcli reBpQnila to output of @8-7 by sounding the beep. 

If you intend Co sovmd the bell in the Apple regardless of 
output device in use, then directly call the routine in the 
Monitor which produces the sound; CAL7- -1059 (or CALL 64477), 
or JSR FBDD expecting destrucrion of the A- reg and Y-reg . 

If you want to sound Che bell of the Apple II if the screen Is the 
print device, or to sound the speaker in the printer, call the 
erttry point In the Etonitor which places a §87 in the A- reg and 
'■'prints" it through COUT; GAT.L-1S8 (or CALL 655M) pr J,SR FF3A 
ei^.&cting destruction of the A-reg,. 
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ADDRESS TABLE 

Function Ilex +nec -Dec Honitor Registers 

Adflr Addr Arid r [.ahrl n.-'ct: rnved 



TF (,A) = $b; wait .yrseconds, thea FBD9 

,MB;it ;01-geeMidBy then soua^ WS-i. P-BOE 
Load f - 152 fol-'.l aec of tell. S FBE2' 
Toggle speaker at 1 KHZ lot Tiutnber Mtk 

of cycles iti Y-reg. 
Print thru COUT "ERR" and bell cedc.FF2D 
I'rlTit bell code (^.R?) thru COUT. FF3A 





-10W 


BELLI 


A,^ 


64477 


-1^.59 




A,t 


W4B2 






A,V 


64486 


-mi 


BEia.2 


A,V 


65325 


-211 


PRERP 


A 




-198 


BKL[. 


A 



CASSETTE TAPE INPUT AND OUTPUT 

'i'hf!re are two pr imary ent ry 7x3 int s in the Moni tor wi th rcgn rd to 

ri'jidlni', ,ind urltiiif! tape. They are RKAI) and IJRI.Tf:. Tlii; requ.i tRments for 
I'dllini; thcwc ,Tre described belnw. There are a number nf other routine 
'•lU ry points wliich are used by the Monitor on hit and byte basis. These 
nrr described below to the entent- pt location in the Monitor and 

I rid I !• .it 1 on of which Ajiple II pro^r.-ima call them, but the preclgf> 

r liiiluf,,-! of Instructions between consccuttvfe calls ts beybad tlWf Scope 

'i( 1 h I s mnnua 1 . 

Ai you will have found by aaw,, bosi& ta^w flies are conposed of one 
rnccirfi, and stmt .&£ two- jEgCOedS-. .fldt tetaB^le-, "L&ftJfSn'g an APPLESOFT or 
BASIC program reSiiltS 1b -two, te^^, Stgjiaiing the enmplet-ions ol the 
rpudH of two aeipitrftt^ records tW ti^e. 

Itoftftltions a't^ ftr ofde?: 



A tape record is a single contiguous string of bits lAiich, is reaa 
Into ar written from memory as a unit. A tape record is a 
(■Uyn ical entity. 



A I i 1 !■ nil tape is a series or sequence oi one or more records 
i imt ,1 1 iitTi[( data In a logical organization. A file ia a logical 

All Ai'l'LI'l.loKT or liASlC proi;ram flla consists of tuo recordH. For liASIC, 

I Ivli rirpt of these records is two bytea long, and contains the length 

iif ( h'' Mi'cond record. Wlien the Monitor has satisfied BASIC'b read of 
till' I i tfil record, RASIC uses the record lenp,th Indicated in that record 

tu (li- C !• rm 1 ne thfe gtact and end points in inemory into which the Monitor 
Will rend tlffi fs&ctJ'vd v^card. Sanh -raaiS to I^AI) -or WRITE in the Monitor 
i(i-i;oiitp:l I'Mh^n (inly ana'- rSeOrd iltpiiE W ouij^t*. 

AfT'liteOTT prrifti'ntns are also SAVEd ag' tteO rt^ijar^ -ae^? 6^ filea. However, 
the rirnt retcird Is three bytes lOng.; tfe ftt^t tifi* fe^'t^^ -fitidicate the 
It-nnrtl, 'inrt tlH' tilled byte is set to $55 to indicate a Bormal APP-LESOFT 

II (hh tlifforcntlated frora APPLESOFT I) program. 
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Some ottier programa write a longer (but fixed length) first record 
containing length of the secOftd. record of the file, and other Infor- 
mation about the flla auch, as date oE creation or Tiame of the f.ile, 

WRITE 

SFECD 63229 -307 



Before entry at thi^ point, sec the first byte address in Alh.li (S3C- 
3D) and the last bytt. address at -V2I.,II (S3E-3F). Tlie Monitor vji 1 1 write 
ten secorJs of continiiouE tone (header) followed by the contents of 
memory as spec-ified, folliiwed by one byte of checksum (the 'result of 
Extloslve OR of all the data bytes vcitteu to the tape). 

READ 

Before entry a.t 'fcW* ("i^A.at., tee, first byt^ addcesa into a1L,!I 

{(ltd the IsS^ Wt« aditeSS -into S,3L,H ($3E-3F). The Monitor 
XmiH the data am ehe tapfe, st<i¥lh;§i: It into nemocy In the specified 
IftCdciotts, 3nd maintaining 3 running Estelusiwe OK result In the zero 
page field called CllKSUM (S2E). When the last specified fnemory location 
fiaS been filled from the tape,, the Monitor reads one nore byte and 
cbtnpares it with the contents of CHKS[JM, If equal, the tlonitoi: sounds a 
beep and returns to Che calllni; prograin. If not equal, Che Monitor 
prints "ERR" through COUT before sounding the beep and returuin;;. 

If you want r.o have the calling progran determine whether the tape whs 
read successfuHy or not, tlien some special actions must he taken. One 
methorf Is to compare the contents of CH ($24) before the tape read with 
the contpntB after. If they are equal, KRR wan not printed to Cli'e. 
screen. If the cursor horizontal position (CH) has changed aej^SsS "ftlle 
call to READ, then ERR must have been written to Che sc*een. M tliiS 
condition Ik encountered, the program c,an j:h;en ask the iX^-pn^gt^' 

position the tape and signal the program ftr anotlier attempt at. reading 
£tie, record, feiiit^oii: if cajL.H points to a yir^nter eard or other 

TQiltiiie ^'cR does not Butput to the screen ^ CH will not be Incremented" 

"by the output df "ERR". 

CASSEHE IPJPUT/OUTPUT INTERNAL ROUTINES 

The following entry polnCs/rouCines functions ^^SiSTjiSeA >, Wfc >ipt 

documented in sufficient detail for call by; us^ jlEe^rw- For. some of 
them, timing is cfi:t¥$cai ftie i!e«;-<aSettMblfiii i&f >%',Ing tiiem would 
depend on bpw they were to he; i^edi 
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HEADF^ 



S i'CO 64713 -B23_ 

■fhiH routine wrif.es the synchronization monotone which is the fi^st 
[>,irt of every cape record. When the M<ITE routine calls IIEADR, it loads 
;i into the A-reg causing a IQ second header to be wrlLLea, The liEAI) 

routine also calls IIEADR to delay from first detection of data coming 
ill fror; Che Cape to the first point at wliich reading for 0/1 detection 
h.y,i:is. READ loads the A-reg with a $16 before calling HEADR so che 
fiflay for hardware settling la set to about, 3"^ seconds. This routine 
is not called by BASIC or APPLESOFT, but it ^-s wsed by the Pro^lEa«iei' '© 
Aid til Tape Verify rautltves sJiich read Ch.e- tape, gjid' compare the- data to 
metiWify instead 9? 9tt>t4^ tfe'e. ^BX^ ittVei ftefiOtyi 



RD2BIT 

$ FCFA 647 6'2 -774 

Thl;i routine clauses looping with decremenClng of the ¥-reg until the 
hardware has indicated two transitions of the tape input register. The 
t'oiiiJnf RniilT Ih called twice for this purpose. Contents of the V- reg 
on return couipaced with contents on entry indicate the length of tine 
It took for the transltlnns. 

i'htfi rmiLliie Is called from within Che Monitor by the READ routine, to 
d.'l.iv entering data tran.^iCer mode until tape input is av.^llahle. READ 
<-(ill.-; (IK.ADB for the 3.5 second delay on return from Its call Co RDZBIT. 
TIHs routine Is also called from APPLESOFT and from the Tape Verify and 
Shape Table Load pcpgrams in the Programmer's Aid #1. 



RDBIT 

SKmj 64765 -771 



Till a routine l^bfiS wi,tlt decirepi'entlng # tMp T-teg ■iubil.g t^^C±*tg' .tiife-' 
tape Input res't-gmr lifiE-tranaitim front ^ro to one- or eite tt, iztem. fitt 
vnlue of zero or cjtie 1b- Hfefc.f^Jdf.p^ ti^ij- E}ie .r^^aiial .^Hn.t iit tlie 

Y-rcR. This routine ig called fcwft wii-hjn IJhe ■ feat tor roatln^s EEZBIt 
mid READ. It is. also called by Pjogrammei-'s Aid, 'ill Tape Verify. 

RDBVTE 

M7i^ -7RR 



'liil'i null 1 111' r,-i 1 1 =! RP^KIT as required in order Co asspinble a byte of 
i n I iiriii:iM on from the cape. It then returns to caller with the byte in 
Mir A-rvR. In iiifdltion to being called from the Monitor READ routine, 
II U nlm cnUed by Shape: Table Load In Programmer'ti Aid #1-. 
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WRBIT 



S PCDfe 6472 6 -810 

Tliis routine aceompllshes writing a bit to the. tnpe when called by 
either thR HEiffiR rautlne or the- iffiBYTE routine. 

WRSYTE 

^ FgED 65261 - 275 

When called Co write a byto to the tape, this uoutine uses WRBIT to 

write ten bits to the tape. The only caller Is ffiLTK, in the Mgnltor^ 

BUTTONS StANNUMiGlATOR I/O 

Xb4 II teas a Gpfe "Ef'fi feaiijitei-tsff' *?t"t^ •is^'eiiMa-KB. support ior- four 

digital output?, th'tee tl%4.-taj i^lJsit^-:, ^ fetux analog Inpute (called 
paddles). Th« ISanltor .reads tfc p.a^dies- ^ Wltlng a strobe to start 
tiie .paddle ti^r aM. ttea rea^li^ the selected paddle timer and 
l-ft&rsfefttilag i"&e %->r$i titttll ttt^ tiiufe'r comes true. The result of the 
Tea4 ""l£( 4* Y-reg. Monitor support for digital outputs or digit 
inpiiCB' iB' nbt required. Acceae to the digital I/O ports Is gained by 
fEEKing or PnKKlng the appropriate address, or by LDx or STx if 
machine laiigua{;c? Is used. The Autostart tfocitor does Initialise the 
digital output ports (annunciators) on any REKKT key interrupt. ANt! 
and ANl are Initialised Co Che clear (TTL W) condition by reference 
to addresses SC0!>8 and 5Ctl3A. AHZ and AN3 a c*i Initialised to the set 
(TTL HI) conditltin by reference to addresses $C05I> and $C(35F. 

To vise the Monitor supporC to read che setting of a paddle, JSR to 
PREAD FBIG 64286 -1250 

With paddle nuraber (9-3) In X-reg, and On rept^rn the "value" of the 
paddle will be found in the Y-reg . A-^re^g. Is i^Sttr^^e^' in the 

■psoCiSBB.i. (APJUISOFT and BASiC, support Ba4&lB- reading, so setting of ^ 
anS Ifi^tet'jig" at: V is- mh j^efj^ir^ there.) 

Direct reading of the paddles may be jiccoraplisiied by accessing the 
paddls' ttiH^ec ^t*j' :8j.l (lai^jB. 'iitiserB. ^ thm m^dina the 

a PPEO-inri'aia pa^^le- Ir^wtt lad^^^^^S '-ckpe^zU&lj '^tlh' eciiJRting until t"h^- 
value read ftim tfe ^ad^W ^'*!"T"e9s no Jbttger has the' ^fl^fl tit g.et. 

CAIJTIOK: After read/ng a paddle, let some tlms' no hy before re.-)ding 

another paddlcj or incorrccC results may be a problem, vnten che paddle 
trigger Is scrohcd, all Che timetH sCsrt. If Che first paddle you 

read has a low valuer, on ;;oing back quickly to read another paddle 
the Cransition you see may be from the first paddle Ctigger Instead 
of the second. Sec the sample program in the section "Use of 
Conttol-Y ulLh Par.meters". Another splutlon is- tt) do a r^d of a 
fake paddle between real readings. 
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GAME IfO HARDWARE ADDRESS TABLE 



Game 1/0 Hardware Address 


Hex 


+De(; 


-Dec 


Action/CommentB 




Addr 


Addr 


Addr 




Start Paadle limeta. 






-U272 




Paddle 3 Ciraor. 


C064 


49252 


-162R4 


Negative iHltH 


Paddle 1 timer. 


C065 


49253 


-1 6283 


timer 


Paddle 2 timet. 


cm 


49254 


-16282 


ffltpl res . 


Paddle 3 Clraer. 


C0&7 


49253 


-16281 




Paddle switch. 


C061 


4924,9 


-16287 


Negativ.^j 


Paddle 1 switch. 


C062 








Vaddle 2 ^switch. 


t;063 






taitt^n pualied. 


Clear' JSitntalG-iator (J .dqt^itft-t. 






— Ls]i£yc) 


.f-QKE/STore 


qet AjiTaincxcitor^ v o'ltpiit. 






aero 


Clear Annunciator 1 output. 


C»SA 


49242 


-16Z94 


to 


Se? Annunciator 1 output. 


C05B 


49243 


-1 62 93 


appropriate 


«lear SSnwdRiats^i^ 2 oatjijit. 


C05C 


49244 


-1 &2.93 


address. 


Set Annunciator 2 output. 


C05D 


49245 


-I'6'291 




Clear Annunciator 3 output. 


C(S5e 


492^^ 


-16290 




Sec Annunciator 3 output. 


C05F 


49247 


-1 6289 





WAIT ROUTINE 



"The WAIT routine consists of a loop within s loop, constructed In 
such a mgnTi.er that the lengch of time spent in the loop varies 
geometricSl^S' .With the entry A-reg. A call to tViis routine will c^iuse 
a loop for a Jt^edictab-I? length of tinej such as is used by the 
Monitor xrith .i^apj^ ' tt*. -i^ jig .the j^e#i!r afi' Sell. It my- ^ 
us,able, fpr eKanple, lo writing data to a lower speed device like a 
printer or a typeV^is'st. 



WAIT 



SFCSa 646S0 -856 



Anaylsis of the code indicates tMS' tte tlise between lihe call WAIT 
(jSaj. and ,ttie -ena' of ■KES' M^is X% mpxpxin^^'g- 

ii.SA'**2' + li.SA + 13 waehlne eyeWs of mi^eraeeeai^s . 

Where A eqwals the contents of the acc-umuiaEnr.. 

An alternative formula is 

TIME TN fllCROSFXONDS - (2.5 * (A~2) + 13.5 * A + MC) * MS 
where A ^ conCenCs of acc.vimulatot 

MC - 13 machine cycles 

MS = 1,023 mi c ros eccinds 

The following table IndicaCes delay times la the WAIT routine Eqc a 
niimber of valvies of the A-reg on entry. 
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WAIT ROUTINE DELAY TIMES 



A-rtig 


Time in 


&-reg 


Time in 




Time In 


<Pec.) 


seconds 


(Dec) 




(Dec.) 




1 


.000029667 


49 


.006830571 


137 


.049907055 


2 


.0Sf005l!S 


50 


.01379^7574 


.138 


.050&2.4178 


3 












4 


i«94&i 


5T 


.007929273 


150 


,^&962S(i24 


5 


.((00146289 


54 


.0082J6736 


151 


.0ES0412242 


6 


.tfU31H8232 


55 


.MHS509314 






7 




5fi 


.a3S!i07007 


162 


.06936963 


8 


.fl0(f2g74h3 


57 


.009109815 


163 


.07KU82a 




.030344751 


58 


.009417738 
i.5f5t973077& 








59 


174^ 




17, 




60 


.0100489aS 
















19 




73 


.014650383! 


xm 


.069141151 






7^ 






.050098679 


25 












26 


.0^2101242 






1^5 


.099955284 








.0196^5129 


19& 


. 100969077 


'U 


.tl02H99J«^2 


86 


.020116272 






32 


.0331*74115: 


96 


.024909027 


204 
205 


.105263561 
.110323339 


36 


.i(H3H24997 


97 


.0254 1M3 5 






37 


.004025505 






2 IS. 


. 12456661S 






105 


.029659S39 


219 


.VZ5S98056 


'.1 


.00487S687 


106 


.030213282 






■42 


,W51iS'S77 






239 


.'49400966 






)Z2 


.03976401 


240 


.150639819 


45 


.0^5813709 


123 


.040404409 






A6 


.006060252 






2.35 


.1698.36414 



USE OF CONTROL-Y WITH PARAMETERS 

In the APPLESOFT nianusl ^m-fs- fes. a caut-^'oii tliat if one paddle la reiid 
anothtr shoulil not be rea€ t:ci:a quickly. Following Is a machine 
laipuage program with *tcli the interference between the paddles can 
be denonscrated. 

Initiate this pro^iran hy eutering the Monitor command xxxxY, where 

xxxx Is a nunber teoresontina the amount of delay to use between 
reading paddle I? and reading patldle 1, and Y repreaents cpncrol-Y. 
The Monitor command "control-Y" causes a JHP to liicaCioii S33r8 at 
which loeatlon "we place a JHP to tlye beSilitii''g the pciJS^ain, 

As the floni Cor scans the input command line, the value of the hex 
diglrs is placed in page siero locations AIL.H ($3C-3D) tor our use. 
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PftDCJLE INTERFERENCE-SAMPLE PROGRAM 



03F8 


.IMP 


S2000 




2000 


LDA 


S«C0 


Set i-ounter for 64 samples to run 


2002 


PTA 


34 


before cleartng &cveen and starting over. 


2004 


LBA 


S3C 


Pick up lov part of entered count from AIL 


2006 


STA 


$10 


and store it for repeated use. 


2308 


LDA 


53 d 


Pick up high part of entered count from Alll 




STA 


Sll 


afl^ stOra it for -cpp&ateA ftSe. 








nt^K 40*? paet QrJ oaujit ; 


2|J3e 


STA 


512 


st'orsa It to esuatiir for this pass. 


2010 




Sll 


atiil. al'^ 5itgh ■psex- 


20 U 




S13 


2014 






Set X for paddle read. 


2816 




%f 




20iS|- 




Store paddle result i-n location 3. 


201B 


mc 


S12 


Count down delay loop low byte: 


201D 




S201B 


VJ^IcIl At!i,0, count QOwlJ n-J-gH IJYt^f 


201F 


DEC 


$13 


2021 


EMI 


S231B 


Stay in the loop until high goes mlwus. 


2023 


LDX 


Si'l 


Set X for paddle 1 read. 


2025 


JSR 


$FB1E 


Call paddle read. 


2)323 


■!m 


SI 


Store tiaddle i resvilt in location 1. 




T riA 


til 

S0 


Pick up padd]e value. 


202C 


JKR 


SFDDA 


Print it as a hex value. 


202F 


LDA 




Pick up a blank to print. 


2031 


J5H 


$F DED 


JTIIUL LIIC DianK. 


2034 


LDA 


SI 


Pit:k up paddle 1 value. 


2036 


JSR 


$FDDA 


Print it as a hex value. 








I'rinC tfiree bljanKs. 




jm. 




D^iay iat- a^titiie 'Txo tee^ ipa^^ls 1, reiM 




im 




troEi upsetting paddle results. 


E0^^it 


tm 




3^ I'fc tX9& to &lmt screen and restart? 


si® 




W a«3Et'S' no, go back and Eample again. 


2044 


Life, 




Vait a while before clearing sci-een. 


2046 


STA 






2048 


STA 


S5 





204a 


INC 






204C 


BiVE 


S204A 




204F 


INC 


S5 




2350 


RKE 


S204A 




2052 


JSR 


$FC58 


Clear the screen. 


2055 


LDA 


SfC0 


Best'uEe the per screen fcbxintar. 


2057 


STA 


S4 




2059 




S200C 


and. go one ixite "big round. 
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REGISTERS FOR BASIC MONITOR CALLS 



Uaxiy of the entry points specified in this book raquirs; RCePfitfiiag. of 
Cegisters for proper operation. Following Is a sample pucfgsamf 
wrltteii ior aPRLSSOFT, which uses Ilonltot calls for conveirriion ffcotn 

Tte "theory feehind the operation Is that on a Monitor G command, the 
rfegiafeffii-s" Qt'e loaded from the SAVE area before Roing to the location 
specified In PCL,H. Thus, by poking destination address Into PCL.H 
and the reqviiced register contents into XREG, YREG, an entry point iil 
the Monitor Go coniinand processor can be used to pass the registers to 
a ee-lecced routine. 



DECIIVIAL TO HEX CONVERSION 

APPLESOFT SAMPLE PROGRAM 



Itf REM OTNVERT DECIMAL INPUT 
100 INPUT "RNTER fflJUBER ";A 
118 IF A=99999 THEN ESD 
150 - A / 256 

200 POKK 71, 
300 ^ / ^56 

3l(J B - fi* * 25fi 

B% - A - B 

POKE 70, B% 
4M POKE 

POKE 58,64 
550 PRINT 
600 CALL 65209 
650 PRINT 
700 GOTO 100 



TO HEX OUTPUT 
Read the Input . 

Pr&vlde a way to end the ptogram. 
ISftlate the high byte. 
SfeC tSES for PRNTYX call, 
'fei E€Hlalnii.ei: £roiT(, A-/25*-. 
Pm lew- Syte O^tKel POICE. 



8?^.t gtlH ta. SF9. 

'^pt PCL to 

f^i'nt a blank line. 

Entry point in GO processor Is KEB?. 

Princ a blank line. 

Go around for another number. 



STEP AND TRACE PECULIARITIES 



The Step and Trace functions in the Old Monitor incorrectly display 
register contents under some circumstances. The STEP routivie detects 
and, gives special aCtenCion to JSR, RTS, ,1?1F, JnV indirect, RTl, and 
BRK inatructioBBv Tn each case, the register contents are displayed 
frop -tl^e .SAVE at. $45-49, However, there is no SAVE call after 

"execution** cff t-hesse itlst«ucii^tiiv *S the.re for noroally %Sacad 
iTistmcti.oiiB, so the TegiEC-ets ■^iWay&f *W« tbpse present in the 
SAVE area, "beEoi:e -execution thf^ instiiK^rtiiSn . 

ThefeEofe, on JSK and RTS", £hs displayed contents of the S-reg are 
Incorrect. On the first instruction after a JSR or RTS> the S-reg 
displays correctly, unless that also ±S an RTS or JSR. 



88 MONITORS PEELED 



The Step and Trace rout'tifeS ar^ not ifteofrect tti hanMahg of ff M% 
instruction. That is, the address displayed for the BRK is correct,. 
Instead of bein^ off by two bytes, because the BRK is detected by the 
STEP xotitl-n« instead of being- execeted by the 6502. 

Although step and trace can be very helpful for some prof.r.im 
debugging tasks, they cannot be used In tracing calls to the Monitor 
(generally inclUiSfng "print" output} oT for pfogTams which use A1L,R 
thru A^L,H. 

Because of the lack of "CLD" at PCADJ (3F953), incorrect addresses 

will be displayed if you set decimal madG ISED) within the program 
being traced or stepped? 
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